WebEngineNewWindowRequest QML Type

A utility type for the WebEngineView::newWindowRequested signal. More...

Import Statement: import QtWebEngine
Since: QtWebEngine 1.12
Instantiates: QWebEngineNewWindowRequest



Detailed Description

Contains information about a request to load a page in a separate web engine view.

See also WebEngineView::newWindowRequested.

Property Documentation

DestinationType : enumeration

Describes how to open a new view:

WebEngineNewWindowRequest.InNewWindowIn a separate window.
WebEngineNewWindowRequest.InNewTabIn a tab of the same window.
WebEngineNewWindowRequest.InNewDialogIn a window without a tab bar, toolbar, or URL bar.
WebEngineNewWindowRequest.InNewBackgroundTabIn a tab of the same window, without hiding the currently visible web engine view.

destination : WebEngineNewWindowRequest::DestinationType [read-only]

The type of window that is requested.

requestedGeometry : QRect [read-only, since QtWebEngine 2.0]

The size that is requested for the new page.

This property was introduced in QtWebEngine 2.0.

requestedUrl : QUrl [read-only, since QtWebEngine 1.5]

The URL that is requested for the new page.

This property was introduced in QtWebEngine 1.5.

userInitiated : bool [read-only]

Whether this window request was directly triggered as the result of a keyboard or mouse event.

You can use this property to block automatic popups.

Method Documentation

openIn(WebEngineView view)

Opens the requested page in the new web engine view view. State and history of the view and the page possibly loaded in it will be lost.

See also WebEngineView::newWindowRequested.

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