QWebEngineNewWindowRequest Class
A utility type for the QWebEnginePage::newWindowRequested() signal. More...
| Header: | #include <QWebEngineNewWindowRequest> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore) target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| Since: | Qt 6.2 |
| Instantiated By: | WebEngineNewWindowRequest |
| Inherits: | QObject |
Public Types
| enum | DestinationType { InNewWindow, InNewTab, InNewDialog, InNewBackgroundTab } |
Properties
- destination : const DestinationType
- requestedGeometry : const QRect
- requestedUrl : const QUrl
- userInitiated : const bool
Public Functions
| QWebEngineNewWindowRequest::DestinationType | destination() const |
| bool | isUserInitiated() const |
| void | openIn(QWebEnginePage *page) |
| QRect | requestedGeometry() const |
| QUrl | requestedUrl() const |
Detailed Description
Contains information about a request to load a page in a separate web engine view.
See also QWebEnginePage::newWindowRequested().
Member Type Documentation
enum QWebEngineNewWindowRequest::DestinationType
This enum describes the type of window requested:
| Constant | Value | Description |
|---|---|---|
QWebEngineNewWindowRequest::InNewWindow | 0 | In a separate window. |
QWebEngineNewWindowRequest::InNewTab | 1 | In a tab of the same window. |
QWebEngineNewWindowRequest::InNewDialog | 2 | In a window without a tab bar, toolbar, or URL bar. |
QWebEngineNewWindowRequest::InNewBackgroundTab | 3 | In a tab of the same window, without hiding the currently visible web engine view. |
Property Documentation
[read-only] destination : const DestinationType
This property holds the type of window that is requested.
Access functions:
| QWebEngineNewWindowRequest::DestinationType | destination() const |
[read-only] requestedGeometry : const QRect
This property holds the size that is requested for the new page.
Access functions:
| QRect | requestedGeometry() const |
[read-only] requestedUrl : const QUrl
This property holds the URL that is requested for the new page.
Access functions:
| QUrl | requestedUrl() const |
[read-only] userInitiated : const bool
Whether this page request was directly triggered as the result of a keyboard or mouse event.
You can use this property to block automatic popups.
Access functions:
| bool | isUserInitiated() const |
Member Function Documentation
void QWebEngineNewWindowRequest::openIn(QWebEnginePage *page)
Opens the requested window in the view represented by page.
See also QWebEnginePage::newWindowRequested.
© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.