Spec-Zone.ru › Qt 5.11

Тип QML WebEngineHistory

Предоставляет модели данных, которые представляют историю страницы веб-движка. Подробнее...

Заявление импорта: import QtWebEngine 1.7
С момента: QtWebEngine 1.1
  • Список всех членов, включая унаследованные члены

Свойства

  • backItems : WebEngineHistoryListModel
  • forwardItems : WebEngineHistoryListModel
  • items : WebEngineHistoryListModel

Подробное описание

К типу WebEngineHistory можно получить доступ, используя свойство WebEngineView.navigationHistory.

Тип WebEngineHistory предоставляет следующие объекты модели данных WebEngineHistoryListModel:

  • backItems, который содержит URL посещённых страниц.
  • forwardItems, который содержит URL страниц, которые были посещены после посещения текущей страницы.
  • items, который содержит URL элементов назад и вперёд, а также URL текущей страницы.

Самый простой способ использования этих моделей — использовать их в ListView, как показано в следующем фрагменте кода:

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

ListView отображает содержимое соответствующей модели. Делегат отвечает за формат элементов списка. Внешний вид каждого элемента списка в делегате может быть определён отдельно (это не специфично для веб-движка).

Роли модели title, url и icon указывают заголовок, URL и значок избранного посещённой страницы. Роль offset указывает позицию страницы по отношению к текущей странице (0). Положительное число указывает, что страница была посещена после текущей страницы, а отрицательное число указывает, что страница была посещена до текущей страницы.

Модели данных также можно использовать для создания меню, как показано в следующем фрагменте кода:

    toolBar: ToolBar {
        id: navigationBar
            RowLayout {
                anchors.fill: parent
                ToolButton {
                    enabled: currentWebView && (currentWebView.canGoBack || currentWebView.canGoForward)
                    menu:Menu {
                        id: historyMenu

                        Instantiator {
                            model: currentWebView && currentWebView.navigationHistory.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.

См. такжеWebEngineHistoryListModel.

Документация по свойствам

[только для чтения] backItems : WebEngineHistoryListModel

URL посещённых страниц.

[только для чтения] forwardItems : WebEngineHistoryListModel

URL страниц, которые были посещены после посещения текущей страницы.

[только для чтения] items : WebEngineHistoryListModel

URL элементов назад, вперёд и текущего элемента в истории.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qml-qtwebengine-webenginehistory.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API