WebEngineHistory QML 类型

提供表示网页浏览器历史的数据模型。更多信息...

导入声明	导入 QtWebEngine
自	QtWebEngine 1.1
实例化	QWebEngineHistory

包括继承成员在内的所有成员列表

属性

backItems : WebEngineHistoryModel
forwardItems : WebEngineHistoryModel
items : WebEngineHistoryModel

方法

void clear() (自 QtWebEngine 1.11)

详细描述

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

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。角色 offset 指定相对于当前页面（0）的位置。正数表示页面是在当前页面之后访问的，而负数表示页面是在当前页面之前访问的。

也可以使用这些数据模型创建菜单，如下面代码段所示

    menuBar: ToolBar {
        id: navigationBar
        RowLayout {
            anchors.fill: parent
            ToolButton {
                enabled: currentWebView && (currentWebView.canGoBack || currentWebView.canGoForward)
                onClicked: historyMenu.open()
                text: qsTr("▼")
                Menu {
                    id: historyMenu
                    Instantiator {
                        model: currentWebView && currentWebView.history.items
                        MenuItem {
                            text: model.title
                            onTriggered: 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 Browser。

另请参阅 WebEngineHistoryModel。

属性文档

backItems : WebEngineHistoryModel [只读]

已访问页面的 URL。

forwardItems : WebEngineHistoryModel [只读]

访问当前页面之后的页面URL。

items : WebEngineHistoryModel [只读]

历史记录中的返回项、前进项和当前项的URL。

方法文档

[自QtWebEngine 1.11起] void clear()

清除历史记录。

此方法在QtWebEngine 1.11中引入。