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
virtual | ~QWebEngineNewWindowRequest() |
QWebEngineNewWindowRequest::DestinationType | destination() const |
bool | isUserInitiated() const |
void | openIn(QWebEnginePage *page) |
QRect | requestedGeometry() const |
QUrl | requestedUrl() const |
Protected Functions
QWebEngineNewWindowRequest(QWebEngineNewWindowRequest::DestinationType, const QRect &, const QUrl &, bool, QSharedPointer<QtWebEngineCore::WebContentsAdapter>, QObject *) |
Protected Variables
QScopedPointer<QWebEngineNewWindowRequestPrivate> | d_ptr |
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
[protected]
QWebEngineNewWindowRequest::QWebEngineNewWindowRequest(QWebEngineNewWindowRequest::DestinationType, const QRect &, const QUrl &, bool, QSharedPointer<QtWebEngineCore::WebContentsAdapter>, QObject *)
Default constructs an instance of QWebEngineNewWindowRequest.
[virtual]
QWebEngineNewWindowRequest::~QWebEngineNewWindowRequest()
Destroys the instance of QWebEngineNewWindowRequest. The destructor is virtual.
void QWebEngineNewWindowRequest::openIn(QWebEnginePage *page)
Opens the requested window in the view represented by page.
See also QWebEnginePage::newWindowRequested.
Member Variable Documentation
QScopedPointer<QWebEngineNewWindowRequestPrivate> QWebEngineNewWindowRequest::d_ptr
© 2022 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.