WebEngineHistory QML Type

Provides data models that represent the history of a web engine page. 更多...

import 语句：	import QtWebEngine
Since:	QtWebEngine 1.1
实例化：	QWebEngineHistory

所有成员列表，包括继承成员

特性

backItems : WebEngineHistoryModel
forwardItems : WebEngineHistoryModel
项 : WebEngineHistoryModel

方法

void clear () (since QtWebEngine 1.11)

详细描述

The WebEngineHistory type can be accessed by using the WebEngineView.history 特性。

The WebEngineHistory type provides the following WebEngineHistoryModel data model objects:

backItems , which contains the URLs of visited pages.
forwardItems , which contains the URLs of the pages that were visited after visiting the current page.
项 , which contains the URLs of the back and forward items, as well as the URL of the current page.

The easiest way to use these models is to use them in a ListView as illustrated by the following code snippet:

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

The ListView shows the content of the corresponding model. The delegate is responsible for the format of the list items. The appearance of each item of the list in the delegate can be defined separately (it is not web engine specific).

The model roles title , url ，和 icon specify the title, URL, and favicon of the visited page. The offset role specifies the position of the page in respect to the current page (0). A positive number indicates that the page was visited after the current page, whereas a negative number indicates that the page was visited before the current page.

The data models can also be used to create a menu, as illustrated by the following code snippet:

    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)
                        }
                    }
                }

For the complete example, see WebEngine Quick 纳米浏览器 .

另请参阅 WebEngineHistoryModel .

特性文档编制

backItems : WebEngineHistoryModel [read-only]

URLs of visited pages.

forwardItems : WebEngineHistoryModel [read-only]

URLs of the pages that were visited after visiting the current page.

项 : WebEngineHistoryModel [read-only]

URLs of back items, forward items, and the current item in the history.

方法文档编制

[since QtWebEngine 1.11] void clear ()

清零历史。

This method was introduced in QtWebEngine 1.11.