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

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.