Класс QWebEngineHistory

Класс QWebEngineHistory представляет историю страниц веб-движка. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Связанные нечлены

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

Каждая страница веб-движка содержит историю посещенных страниц, к которой можно получить доступ через QWebEnginePage::history().

История использует понятие текущего элемента, разделяя посещенные страницы на те, которые можно посетить, перемещаясь назад и вперед с помощью функций back() и forward(). Текущий элемент можно получить, вызвав currentItem(), а произвольный элемент в истории можно сделать текущим, передав его в goToItem().

Список элементов, описывающих страницы, которые можно посетить, переходя назад, можно получить, вызвав функцию backItems(); аналогично, элементы, описывающие страницы, которые находятся после текущей страницы, можно получить с помощью функции forwardItems(). Полный список элементов получается с помощью функции items().

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

• backItemsModel(), который содержит URL-адреса посещенных страниц.
• forwardItemsModel(), который содержит URL-адреса страниц, посещенных после текущей страницы.
• itemsModel(), который содержит URL-адреса элементов назад и вперед, а также URL-адрес текущей страницы.

Так же, как и для контейнеров, доступны функции для проверки истории в терминах списка. Произвольные элементы в истории можно получить с помощью itemAt(), общее количество элементов задается count(), а историю можно очистить с помощью функции clear().

Состояние QWebEngineHistory можно сохранить в QDataStream с помощью оператора >> и загрузить с помощью оператора <<.

См. также QWebEngineHistoryItem и QWebEnginePage.

Документация по функциям-членам

void QWebEngineHistory::back()

Устанавливает текущий элемент в предыдущий элемент в истории и переходит на соответствующую страницу; то есть, переходит назад на один элемент истории.

См. также forward() и goToItem().

QWebEngineHistoryItem QWebEngineHistory::backItem() const

Возвращает элемент, предшествующий текущему элементу в истории.

QList<QWebEngineHistoryItem> QWebEngineHistory::backItems(int maxItems) const

Возвращает список элементов в списке истории назад. Возвращаются не более maxItems элементов.

См. также forwardItems().

QWebEngineHistoryModel *QWebEngineHistory::backItemsModel() const

Возвращает модель данных, которая представляет URL-адреса посещенных страниц.

Примечание: Функция-получатель для свойства backItems.

bool QWebEngineHistory::canGoBack() const

Возвращает true если существует элемент, предшествующий текущему элементу в истории; в противном случае возвращает false.

См. также canGoForward().

bool QWebEngineHistory::canGoForward() const

Возвращает true если существует элемент для перехода вперед; в противном случае возвращает false.

См. также canGoBack().

[invokable] void QWebEngineHistory::clear()

Очищает историю.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

См. также count() и items().

int QWebEngineHistory::count() const

Возвращает общее количество элементов в истории.

QWebEngineHistoryItem QWebEngineHistory::currentItem() const

Возвращает текущий элемент в истории.

int QWebEngineHistory::currentItemIndex() const

Возвращает индекс текущего элемента в истории.

void QWebEngineHistory::forward()

Устанавливает текущий элемент в следующий элемент в истории и переходит на соответствующую страницу; то есть, переходит вперед на один элемент истории.

См. также back() и goToItem().

QWebEngineHistoryItem QWebEngineHistory::forwardItem() const

Возвращает элемент, следующий за текущим элементом в истории.

QList<QWebEngineHistoryItem> QWebEngineHistory::forwardItems(int maxItems) const

Возвращает список элементов в списке истории вперёд. Возвращается не более maxItems записей.

См. также backItems().

QWebEngineHistoryModel *QWebEngineHistory::forwardItemsModel() const

Возвращает модель данных, представляющую URL-адреса страниц, которые были посещены после посещения текущей страницы.

Примечание: Функция-геттер для свойства forwardItems.

void QWebEngineHistory::goToItem(const QWebEngineHistoryItem &item)

Устанавливает текущий элемент в указанный элемент item в истории и переходит на страницу.

См. также back() и forward().

QWebEngineHistoryItem QWebEngineHistory::itemAt(int i) const

Возвращает элемент с индексом i в истории.

QList<QWebEngineHistoryItem> QWebEngineHistory::items() const

Возвращает список всех элементов, которые в настоящее время находятся в истории.

См. также count() и clear().

QWebEngineHistoryModel *QWebEngineHistory::itemsModel() const

Возвращает модель данных, представляющую URL-адреса элементов назад, вперёд и текущего элемента в истории.

Примечание: Функция-геттер для свойства items.