WebEngineHistory QML Type

Stellt Datenmodelle zur Verfügung, die die Historie einer Seite der Webmaschine darstellen. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• backItems : WebEngineHistoryModel
• forwardItems : WebEngineHistoryModel
• items : WebEngineHistoryModel

Methoden

• void clear() (since QtWebEngine 1.11)

Detaillierte Beschreibung

Auf den Typ WebEngineHistory kann über die Eigenschaft WebEngineView.history zugegriffen werden.

Der Typ WebEngineHistory bietet die folgenden WebEngineHistoryModel Datenmodellobjekte:

• backItemsWebEngineHistory, das die URLs der besuchten Seiten enthält.
• forwardItemsWebEngineHistory enthält die URLs der Seiten, die nach dem Besuch der aktuellen Seite besucht wurden.
• itemsDie URLs der Seiten, die nach dem Besuch der aktuellen Seite besucht wurden, sowie die URL der aktuellen Seite.

Die einfachste Art, diese Modelle zu verwenden, ist die Verwendung in einer ListView, wie der folgende Codeschnipsel zeigt:

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

Die ListView zeigt den Inhalt des entsprechenden Modells an. Der Delegat ist für das Format der Listenelemente verantwortlich. Das Aussehen jedes Listenelements im Delegaten kann separat definiert werden (es ist nicht web engine-spezifisch).

Die Modellrollen title, url und icon geben den Titel, die URL und das Favicon der besuchten Seite an. Die Rolle offset gibt die Position der Seite in Bezug auf die aktuelle Seite (0) an. Eine positive Zahl bedeutet, dass die Seite nach der aktuellen Seite besucht wurde, während eine negative Zahl bedeutet, dass die Seite vor der aktuellen Seite besucht wurde.

Die Datenmodelle können auch zur Erstellung eines Menüs verwendet werden, wie das folgende Codeschnipsel zeigt:

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

Das vollständige Beispiel finden Sie unter WebEngine Quick Nano Browser.

Siehe auch WebEngineHistoryModel.

Dokumentation der Eigenschaften

Dokumentation der Methode