WebEngineHistory QML Type

ウェブエンジンページの履歴を表すデータモデルを提供する。詳細...

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

プロパティ

メソッド

  • 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 、対応するモデルの内容が表示されます。デリゲートはリスト項目の書式を担当します。デリゲートにおけるリストの各項目の外観は、個別に定義することができます(ウェブエンジン固有のものではありません)。

モデルのtitleurliconの役割は、訪問したページのタイトル、URL、ファビコンを指定します。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 [read-only]

訪問したページの URL。


forwardItems : WebEngineHistoryModel [read-only]

現在のページにアクセスした後にアクセスしたページの URL。


items : WebEngineHistoryModel [read-only]

履歴の戻る項目、進む項目、現在の項目の URL。


メソッド・ドキュメント

[since QtWebEngine 1.11] void clear()

履歴を消去します。

このメソッドは QtWebEngine 1.11 で導入されました。


©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。