WebEngineView QML Type

描述各种高级错误类型：

描述了findText() 函数的可用选项。这些选项可以从以下列表中选择：

另请参阅 findText()。

表示 JavaScript 控制台消息的严重程度：

该枚举描述页面的生命周期状态：

此属性在 QtWebEngine 1.10 中引入。

另请参阅 lifecycleState 、页面生命周期 API 和WebEngine 生命周期示例。

反映页面的加载状态：

描述从WebEngineView 内容创建的 PDF 文档的方向。枚举值映射自QPageLayout::Orientation ，且必须与之匹配。

该属性在 QtWebEngine 1.3 中引入。

另请参阅 WebEngineView::printToPdf().

该枚举类型列出了 Postscript PPD 标准中定义的可用页面尺寸。

枚举值映射自QPageSize::PageSizeId ，且必须与之匹配。这些值在QPagedPaintDevice 和QPrinter 中也有重复。

定义的页面大小为

此属性在 QtWebEngine 1.3 中引入。

另请参阅 WebEngineView::printToPdf().

描述渲染进程终止的状态：

此属性在 QtWebEngine 1.2 中引入。

描述了可在网页上执行的操作类型：

此属性在 QtWebEngine 1.2 中引入。

指定按下时视图是否应获得活动焦点。默认值是true 。

该属性在 QtWebEngine 1.2 中引入。

当前页面音频是否静音的状态。

该属性在 QtWebEngine 1.3 中引入。

另请参阅 recentlyAudible 。

改变WebEngineView 文档正文后面的背景颜色。可设置为"transparent" 或半透明色，以透视文档，或与混合应用程序中的网页内容相匹配，以防止加载过程中可能出现的白色闪烁。

默认值为白色。

此属性在 QtWebEngine 1.2 中引入。

如果有先前的会话历史条目，则返回true ，否则返回false 。

如果有后续会话历史条目，则返回true ，否则返回false 。

页面内容的大小。

该属性在 QtWebEngine 1.3 中引入。

与该页面关联的开发工具主机的 id。

如果启用了远程调试（请参阅Qt WebEngine Developer Tools），该 id 可用于构建连接到开发工具 websocket 的 URL：ws://localhost:<debugging-port>/devtools/page/<id>) 。该 websocket 可用于使用DevTools 协议与页面交互。

该属性在 QtWebEngine 6.6 中引入。

当前托管该视图的开发工具的视图。将其设置为一个新视图将导航该视图到一个带有开发工具的内部 URL，并将其绑定到该视图。

此属性在 QtWebEngine 1.7 中引入。

另请参阅 inspectedView 。

当前视图的导航历史。

该属性在 QtWebEngine 1.1 中引入。

另请参阅 WebEngineHistory 。

内部 URL 用于访问当前显示的网站图标，也称为 favicon 或快捷图标。该只读 URL 与移动浏览器应用程序中用于在设备主屏幕上显示书签页面的图片相对应。

以下代码段使用icon 属性创建了一个Image 组件：

Image {
    id: appIcon
    sourceSize: Qt.size(32, 32)
    source: webView.icon != "" ? webView.icon : "fallbackFavicon.png";
    // ...
}

指定Image::sourceSize 属性可通知Qt WebEngine 的 favicon 提供商所要求的大小，并按此调整图标大小。如果未指定Image::sourceSize 属性，提供商将以最大可用分辨率提供图标。

该视图当前正在检查的视图（如果有）。设置该属性将导航到带有视图集开发工具的内部 URL。

建议在开发工具不可见时取消设置该属性，否则一些调试信息可能会出现在被检查的WebEngineView 中。

此属性在 QtWebEngine 1.7 中引入。

另请参阅 devToolsView 。

如果 web 视图处于全屏模式，则返回true ，否则返回false 。

此属性在 QtWebEngine 1.1 中引入。

另请参阅 fullScreenRequested() 和fullScreenCancelled() 。

页面的当前生命周期状态。

设置器强制执行以下限制：

• 可见页面必须保持Active 状态。
• 如果页面正在被devToolsView 检查，则两个页面都必须保持Active 状态。
• 处于Discarded 状态的页面只能过渡到Active 状态。这将导致页面重新加载。

这些是对生命周期状态的唯一硬限制，但推荐的软限制也请参见recommendedState 。

该属性在 QtWebEngine 1.10 中引入。

另请参阅 recommendedState 、页面生命周期 API 和WebEngine 生命周期示例。

已加载的页面数据量，以0 至100 范围内的整数百分比表示。

如果 HTML 页面当前正在加载，则返回true ，否则返回false 。

页面的顶层主框架。页面上的所有其他框架都可以作为主框架的子框架访问。

此属性在 QtWebEngine 6.8 中引入。

视图使用的当前配置文件。

该属性在 QtWebEngine 1.1 中引入。

另请参阅 WebEngineProfile 。

返回当前页面的声音状态（最近是否播放过音频）。

该属性在 QtWebEngine 1.3 中引入。

另请参阅 audioMuted 和recentlyAudibleChanged 。

页面生命周期状态的推荐限制。

将生命周期状态设置为比推荐状态更低的资源使用状态可能会导致副作用，如停止后台音频播放或丢失 HTML 表单输入。不过，将生命周期状态设置为较高的资源状态是完全安全的。

此属性在 QtWebEngine 1.10 中引入。

另请参阅 lifecycleState 、页面生命周期 API 和WebEngine 生命周期示例。

返回分配给当前页面主框架的呈现进程的进程 ID (PID)。

如果还没有可用的呈现进程，则返回0 。

此属性在 QtWebEngine 1.11 中引入。

另请参阅 renderProcessPidChanged 。

页面内容的滚动位置。

该属性在 QtWebEngine 1.3 中引入。

该视图使用的设置。

该属性在 QtWebEngine 1.1 中引入。

另请参阅 WebEngineSettings 。

当前显示的 HTML 页面的标题。这是一个只读值，反映了<title> 标签的内容。

touchHandleDelegate 提供了一个模板，用于定义视图实例化的可视化触摸句柄，无论何时需要进行触摸选择处理。

手柄的位置、不透明度和可见性会自动更新。委托应是 QML Item 或任何继承它的 QML 类型。

下面的代码使用了自定义的触摸手柄委托：

WebEngineView {
// ...
    touchHandleDelegate: Rectangle {
        color: "red"
    }
    // ...
}

触摸手柄也可以动态切换：

 Component {
    id: circleTouchHandle
    Rectangle {
        color: "blue"
        radius: 50
    }
}
function showDefaultHandle(isDefault) {
    if (isDefault)
        webEngineView.touchHandleDelegate = circleTouchHandle
    else
        webEngineView.touchHandleDelegate = null
}

此属性在 QtWebEngine 6.4 中引入。

当前显示的 HTML 页面的位置。此可写属性提供了将页面加载到 Web 视图的主要接口。其功能与window.location DOM 属性相同。

另请参阅 loadHtml().

与视图关联的用户脚本集合。

该属性在 QtWebEngine 1.1 中引入。

另请参阅 WebEngineScriptCollection 。

该视图使用的网络通道实例。该通道通过 Chromium IPC 自动使用内部QtWebEngine 传输机制，并在渲染页面的 javascript 上下文中以qt.webChannelTransport 的形式显示。在使用Qt WebChannel JavaScript API 实例化QWebChannel 的 JavaScript 对应程序时，将使用此传输对象。

该属性在 QtWebEngine 1.1 中引入。

该视图使用的 web 通道实例所安装的 JavaScript 世界。world 必须是介于0 和256 之间的数字。

该属性在 QtWebEngine 1.3 中引入。

视图的缩放系数。有效值范围为0.25 至5.0 。默认系数为1.0 。

该属性在 QtWebEngine 1.1 中引入。

activeFocusOnPress 的值发生变化时会发出该信号。它指定按下时视图是否应获得活动焦点。

该信号在 QtWebEngine 1.2 中引入。

另请参阅 activeFocusOnPress 和setActiveFocusOnPress() 。

当muted 的值发生变化时会发出该信号。该值通过audioMuted 属性指定。

此信号在 QtWebEngine 1.3 中引入。

另请参阅 audioMuted 和recentlyAudibleChanged 。

该信号在请求认证对话框时发出。

可以使用AuthenticationDialogRequest 类型的方法处理request 。

该信号在 QtWebEngine 1.4 中引入。

当网络引擎视图背景颜色发生变化时会发出该信号。

此信号在 QtWebEngine 1.2 中引入。

当加载给定请求时出现无效证书错误（error ）时，就会发出该信号。

可使用WebEngineCertificateError 类型的方法处理证书错误。

此信号在 QtWebEngine 1.1 中引入。

该信号在请求颜色选择器对话框时发出。

可以使用ColorDialogRequest 类型的方法处理request 。

该信号在 QtWebEngine 1.4 中引入。

该信号在请求上下文菜单时发出。

request 可通过使用ContextMenuRequest 类型的属性来处理。

该信号在 QtWebEngine 1.4 中引入。

当网络应用程序请求访问显示内容时，就会发出该信号。

request 参数包含可用于捕获的窗口和屏幕的数据模型引用。要接受请求，信号处理程序可调用WebEngineDesktopMediaRequest::selectScreen() 或WebEngineDesktopMediaRequest::selectWindow() 。

此信号在 QtWebEngine 6.7 中引入。

该信号在请求使用文件选取器对话框时发出。

可以使用FileDialogRequest 类型的方法处理request 。

该信号在 QtWebEngine 1.4 中引入。

result 是字符串搜索的结果。

该信号在 QtWebEngine 1.10 中引入。

另请参阅 findText() 和FindTextResult 。

当网页通过 JavaScript API 发布request 全屏模式时，会发出该信号。

此信号在 QtWebEngine 1.1 中引入。

另请参阅 isFullScreen 。

每当文档要改变页面的位置和大小时，frameGeometry ，就会发出这个信号。例如，可以通过 JavaScript 来实现。

frameGeometry 包括框架边距的大小，而geometry 不包括框架边距的大小。

onGeometryChangeRequested: {
    window.x = geometry.x
    window.y = geometry.y
    window.width = geometry.width
    window.height = geometry.height
}

此信号在 QtWebEngine 1.7 中引入。

当 JavaScript 程序尝试将message 打印到 Web 浏览器的控制台时，就会发出该信号。

例如，在评估错误的情况下，源 URL 可以在sourceID 以及lineNumber 中提供。

level 表示触发该消息的事件的严重程度，即是由错误触发还是由不太严重的事件触发。

如果没有指定处理程序，视图会将消息记录到js logging category 。

另请参阅 控制台日志记录。

该信号在请求 JavaScript 对话框时发出。

可以使用JavaScriptDialogRequest 类型的方法处理request 。

该信号在 QtWebEngine 1.4 中引入。

在鼠标驱动的界面中，当鼠标指针经过链接时会发出该信号，对应于mouseover DOM 事件。在触摸界面中，如果mouseover 事件没有被preventDefault() 取消，也会发生该事件。hoveredUrl 提供链接的位置。

该信号在页面加载开始、结束或失败时发出。

使用onLoadingChanged 处理该信号时，可在loadingInfo 指定的WebEngineLoadingInfo 上获取各种只读参数。

另请参阅 loading 、LoadStatus 和ErrorDomain 。

当发出导航请求request 时，会发出该信号。

当request 在单独的网络引擎视图中加载页面时，会发出该信号。这可能是因为当前页面通过 JavaScript 调用window.open 明确请求加载页面，也可能是因为用户在按住 Shift、Ctrl 或内置组合键的同时点击了一个链接，从而触发页面在新窗口中打开。

处理该信号的方法是在目标视图上调用acceptAsNewWindow() 。如果未处理该信号，请求的加载将失败。

示例实现：

QtObject {
    id: windowParent
    // Create the initial browsing windows and open the startup page.
    Component.onCompleted: {
        var firstWindow = windowComponent.createObject(windowParent);
        firstWindow.webView.loadHtml('<input type="button" value="Click!" onclick="window.open(&quot;http://qt.io&quot;)">');
    }

    property Component windowComponent: Window {
        // Destroy on close to release the Window's QML resources.
        // Because it was created with a parent, it won't be garbage-collected.
        onClosing: destroy()
        visible: true

        property WebEngineView webView: webView_
        WebEngineView {
            id: webView_
            anchors.fill: parent

            // Handle the signal. Dynamically create the window and
            // use its WebEngineView as the destination of our request.
            onNewWindowRequested: function(request) {
                var newWindow = windowComponent.createObject(windowParent);
                newWindow.webView.acceptAsNewWindow(request);
            }
        }
    }
}

该信号在 QtWebEngine 2.0 中引入。

另请参阅 WebEngineNewWindowRequest 和WebEngine Quick Nano 浏览器。

filePath 将包含请求创建文件的路径，如果文件创建成功，success 将为true ，否则为false 。

该信号在 QtWebEngine 1.5 中引入。

另请参阅 printToPdf() 。

当网站提出权限请求（如地理位置访问权限、发送通知权限）时，就会发出该信号。permission 对象可查询请求 URL 和请求的WebEnginePermission.PermissionType ，以及授予或拒绝权限。

该信号在 QtWebEngine 6.8 中引入。

当调用主框架上的 JavaScriptwindow.print() 方法或用户按下 PDF 浏览器插件的打印按钮时，就会发出该信号。通常，信号处理程序只需调用printToPdf() 即可。

自QtWebEngine 6.8 起，该信号只在主帧上发出，而不是在任何请求打印的帧上发出。

该信号在 QtWebEngine 1.8 中引入。

另请参阅 printToPdf 。

当调用frame 上的 JavaScriptwindow.print() 方法时，会发出该信号。如果框架是主框架，则会发出printRequested 信号。

该信号在 QtWebEngine 6.8 中引入。

另请参阅 printRequested 。

当页面的可听状态（由recentlyAudible 指定）因音频播放或停止而发生变化时，将发出该信号。

如果一个网页包含两个依次启动的视频，该信号只在第一个视频发出声音时发出一次。两个视频停止后，信号会在最后一个视频发出声音时发出。这就意味着，无论网页内有多少音频流，只要有任何声音产生，或者网页内完全没有任何声音，都会发射信号。

杂散信号发射也可能发生。例如，当声音停止时，该信号会首先以true 的值发射，然后以false 的值发射。此外，当开始播放音频时，该信号会以true 的值发射两次。

该信号在 QtWebEngine 1.3 中引入。

另请参阅 recentlyAudible 。

当网页试图通过发出registerProtocolHandler request 注册自定义协议时，就会发出该信号。

该信号在 QtWebEngine 1.7 中引入。

另请参阅 RegisterProtocolHandlerRequest 。

如果还没有可用的呈现进程，则返回0 。当页面底层呈现进程的pid （进程 ID）发生变化时，就会发出该信号。

此信号在 QtWebEngine 1.11 中引入。

另请参阅 renderProcessPid 。

terminationStatus 是进程的终止状态，exitCode 是进程终止时的状态代码。

此信号在 QtWebEngine 1.2 中引入。

另请参阅 RenderProcessTerminationStatus 。

当网站请求 SSL 客户证书，并在系统的客户证书存储中找到一个或多个证书时，就会发出该信号。

对该信号的处理是异步的，加载将一直持续到选择了证书或clientCertificateSelection 的最后一份副本被销毁。

如果未处理该信号，clientCertificateSelection 将自动销毁，并在没有客户证书的情况下继续加载。

此信号在 QtWebEngine 1.9 中引入。

另请参阅 WebEngineClientCertificateSelection 。

当网页发送request 以在指定位置显示工具提示时，将发出该信号。

该信号在 QtWebEngine 1.10 中引入。

另请参阅 TooltipRequest 。

在指定位置请求触摸选择菜单时会发出该信号。

request 可通过使用TouchSelectionMenuRequest 类型的方法来处理。

该信号在 QtWebEngine 6.3 中引入。

另请参阅 TouchSelectionMenuRequest 。

当播放或停止音频导致页面的可听状态（由wasRecentlyAudible 指定）发生变化时，将发出该信号。

该信号在 QtWebEngine 1.3 中引入。

当 WebAuth 身份验证器在身份验证过程中需要用户交互时，就会发出这个信号。处理这些请求的方式是向用户显示一个对话框。

request 包含完成 WebAuth UX 请求所需的信息和 API。

该信号在 QtWebEngine 6.7 中引入。

另请参阅 QWebEngineWebAuthUxRequest 。

每当页面请求关闭网页浏览器窗口（例如通过 JavaScriptwindow.close() 调用）时，就会发出该信号。

此信号在 QtWebEngine 1.2 中引入。

每当页面的缩放factor 发生变化时，就会发出该信号。

此信号在 QtWebEngine 6.8 中引入。

另请参阅 zoomFactor 。

在网页视图内容中运行指定的script 。

callback 参数为可选参数。如果提供了回调函数，脚本运行结束后将调用该函数。

runJavaScript("document.title", function(result) { console.log(result); });

从 JavaScript 返回的结果值只能是纯数据。支持的数据类型包括所有 JSON 数据类型以及Date 和ArrayBuffer 等。不支持的数据类型包括Function 和Promise 等。

为避免与页面上执行的其他脚本冲突，可通过worldId 指定运行脚本的世界。世界 ID 必须介于0 和256 之间。如果省略world ID，脚本将在MainWorld 中运行。

有关注入脚本的更多信息，请参阅脚本注入。有关注入脚本的其他方法，请参阅WebEngineView::userScripts 。

通过在该视图中打开request 来处理newWindowRequested 信号。

此方法在 QtWebEngine 2.0 中引入。

另请参阅 newWindowRequested 。

Returns aWebEngineAction for the specifiedWebAction action .WebEngineView 还负责实现动作，以便在触发时在视图上执行相应的动作。

var copyAction = webEngineView.action(WebEngineView.Copy);

另请参见 WebEngineAction 。

返回名称为name 的框架。如果存在多个同名框架，则任意返回其中一个。如果没有找到框架，则返回一个invalid 框架。

此方法在 QtWebEngine 6.8 中引入。

在页面中查找指定的字符串subString 。字符串搜索完成后，会发出findTextFinished() 信号。

要清除搜索高亮，只需传递一个空字符串即可。

此方法在 QtWebEngine 1.1 中引入。

另请参阅 findTextFinished().

使用给定的options 在页面中查找指定的字符串subString 。字符串搜索完成后，会发出findTextFinished() 信号。

要清除搜索高亮，只需传递一个空字符串即可。

findText("Qt", WebEngineView.FindBackward | WebEngineView.FindCaseSensitively);

此方法在 QtWebEngine 1.1 中引入。

另请参阅 findTextFinished() 。

使用给定的options 在页面中查找指定的字符串subString 。字符串搜索完成后，会发出findTextFinished() 信号。

要清除搜索高亮，只需传递空字符串即可。

resultCallback 必须接受一个整数参数。调用该信号时，将显示找到的subString 的出现次数。

findText("Qt", WebEngineView.FindCaseSensitively, function(matchCount) {
    if (matchCount > 0)
        console.log("'Qt' tokens found:", matchCount);
});

该方法在 QtWebEngine 1.1 中引入。

另请参阅 findTextFinished().

立即将isFullScreen 属性设置为false 。当窗口系统强制应用程序离开全屏模式时，它可用于通知浏览器引擎。

ApplicationWindow {
    onVisibilityChanged: {
        if (webEngineView.isFullScreen && visibility != Window.FullScreen)
            webEngineView.fullScreenCancelled()
    }

    WebEngineView {
        id: webEngineView
        // ...
    }
}

此方法在 QtWebEngine 1.1 中引入。

另请参阅 isFullScreen 和fullScreenRequested() 。

如果可能，在浏览器的会话历史中向后退。此函数等同于window.history.back() DOM 方法。

另请参阅 canGoBack 。

如果offset 为正数，则向前移动当前会话历史中指定的偏移页数。如果偏移量为负数，则返回。如果偏移量无效，则不会更改页面。

此方法在 QtWebEngine 1.1 中引入。

另请参阅 goBack() 和goForward() 。

如果可能，在浏览器的会话历史中向前移动。此函数等同于window.history.forward() DOM 方法。

加载指定的html 作为网页视图的内容。

该方法是url 属性的低级替代方法，后者通过 URL 引用 HTML 页面。

baseUrl 是可选项，用于解析文档中的相对 URL，如引用的图像或样式表。例如，如果 是通过 （基本 URL）获取的，那么通过相对 URL 引用的图像应位于 。html http://www.example.com/documents/overview.html diagram.png http://www.example.com/documents/diagram.png

另请参阅 url 。

将WebEngineView 的当前内容打印为 PDF 文档并存储在filePath 下。文档的大小将由pageSizeId 的值决定，其方向将由orientation 决定。

该方法发出异步请求，将网页打印成 PDF 文件，并立即返回。要了解请求的结果，请连接信号pdfPrintingFinished() 。

如果省略pageSizeId ，则默认为A4 。如果省略orientation ，则默认为Portrait 。

此方法在 QtWebEngine 1.3 中引入。

另请参阅 pdfPrintingFinished().

将WebEngineView 的当前内容打印为 PDF 文档，并以字节数组形式返回。文档的大小由pageSizeId 的值决定，其方向由orientation 决定。

resultCallback 必须接受一个字符串参数。如果打印成功，该字符串将包含文档数据，反之则为空字符串。

如果省略pageSizeId ，则默认为A4 。如果省略orientation ，则默认为Portrait 。

此方法在 QtWebEngine 1.3 中引入。

重新读取当前页面。此函数等同于window.location.reload() DOM 方法。

另请参阅 reloadAndBypassCache() 。

重新读取当前页面，忽略任何缓存内容。

此方法在 QtWebEngine 1.1 中引入。

另请参阅 reload().

用replacement 替换当前拼写错误的单词。

此方法在 QtWebEngine 1.3 中引入。

将当前网页保存到磁盘。

网页将保存到filePath 指定的format 中。

这是以下操作的快捷方式：

• 触发保存网页操作。
• 接受下一个下载项目，并设置指定的文件路径和保存格式。

该函数为网页发出异步下载请求并立即返回。

此方法在 QtWebEngine 6.6 中引入。

另请参阅 QWebEngineDownloadRequest::SavePageFormat 。

如果arg 是true ，则将主动焦点设置为被点击的网络引擎视图。通过将其设置为false ，网络引擎视图可用于创建不应获得焦点的 UI 元素。这在混合 UI 中非常有用。

此方法在 QtWebEngine 1.2 中引入。

另请参阅 activeFocusOnPress,activeFocusOnPressChanged, 和WebEngineSettings::focusOnNavigationEnabled 。

停止加载当前页面。

触发网络操作action 。

此方法在 QtWebEngine 1.2 中引入。

另请参阅 WebAction 。