WebEngineHistory QML Type

提供表示网络引擎页面历史的数据模型。更多

Import Statement:	`import QtWebEngine`
Since:	QtWebEngine 1.1
In C++:	QWebEngineHistory

所有成员（包括继承成员）的列表

属性

backItems : WebEngineHistoryModel
forwardItems : WebEngineHistoryModel
items : WebEngineHistoryModel

方法

void clear() (since QtWebEngine 1.11)

详细说明

WebEngineHistory 类型可通过WebEngineView.history 属性访问。

WebEngineHistory 类型提供以下WebEngineHistoryModel 数据模型对象：

backItems，其中包含已访问页面的 URL。
forwardItems包含访问过的页面的 URL。
items包含后退和前进项目的 URL 以及当前页面的 URL。

使用这些模型的最简单方法是在ListView 中使用它们，如下代码片段所示：

ListView {
    id: historyItemsList
    anchors.fill: parent
    model: webEngineView.history.items
    delegate:
        Text {
            color: "black"
            text: model.title + " - " + model.url + " (" + model.offset + ")"
        }
}

ListView 显示相应模型的内容。委托负责列表项的格式。委托中列表中每个项的外观可以单独定义（与网络引擎无关）。

模型角色title、url 和icon指定访问页面的标题、URL 和 favicon。偏移量角色指定页面相对于当前页面（0）的位置。正数表示该页面在当前页面之后被访问，负数表示该页面在当前页面之前被访问。

数据模型还可用于创建菜单，如下代码片段所示：

    menuBar: ToolBar {
        id: navigationBar
        RowLayout {
            anchors.fill: parent
            ToolButton {
                enabled: win.currentWebView?.canGoBack || win.currentWebView?.canGoForward
                onClicked: historyMenu.open()
                text: qsTr("▼")
                Menu {
                    id: historyMenu
                    Instantiator {
                        model: win.currentWebView?.history?.items
                        MenuItem {
                            required property var model
                            text: model.title
                            onTriggered: win.currentWebView.goBackOrForward(model.offset)
                            checkable: !enabled
                            checked: !enabled
                            enabled: model.offset
                        }

                        onObjectAdded: function(index, object) {
                            historyMenu.insertItem(index, object)
                        }
                        onObjectRemoved: function(index, object) {
                            historyMenu.removeItem(object)
                        }
                    }
                }

有关完整示例，请参阅WebEngine Quick Nano 浏览器。

另请参阅 WebEngineHistoryModel 。

属性文档

backItems : WebEngineHistoryModel [read-only]

WebEngineHistoryModel 对象，可用于提取有关返回项的信息；即在当前页面之前访问过的页面。

另请参阅 WebEngineHistoryModel,forwardItems, 和items 。

forwardItems : WebEngineHistoryModel [read-only]

WebEngineHistoryModel 对象，用于提取前向项目的信息；即在当前页面之后访问的页面。

另请参阅 WebEngineHistoryModel,backItems, 和items 。

items : WebEngineHistoryModel [read-only]

WebEngineHistoryModel 对象，用于提取历史记录中有关后退项目、前向项目和当前项目的信息。

另请参阅 WebEngineHistoryModel,backItems, 和forwardItems 。

方法文档

[since QtWebEngine 1.11] void clear()

清除历史记录。

该方法在 QtWebEngine 1.11 中引入。

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