QWebEngineNewWindowRequest Class

A utility type for the QWebEnginePage::newWindowRequested() signal. More...

Header: #include <QWebEngineNewWindowRequest>
CMake: find_package(Qt6 COMPONENTS WebEngineCore REQUIRED)
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

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:

ConstantValueDescription
QWebEngineNewWindowRequest::InNewWindow0In a separate window.
QWebEngineNewWindowRequest::InNewTab1In a tab of the same window.
QWebEngineNewWindowRequest::InNewDialog2In a window without a tab bar, toolbar, or URL bar.
QWebEngineNewWindowRequest::InNewBackgroundTab3In 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.

© 2021 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.