Класс QWebEngineHistory

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

Этот класс был представлен в Qt 5.4.

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

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

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

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

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

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

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

Так же, как и с контейнерами, доступны функции для проверки истории в терминах списка. Произвольные элементы в истории можно получить с помощью 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().

bool QWebEngineHistory::canGoBack() const

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

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

bool QWebEngineHistory::canGoForward() const

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

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

void QWebEngineHistory::clear()

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

См. также 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().

void QWebEngineHistory::goToItem(const QWebEngineHistoryItem &item)

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

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

QWebEngineHistoryItem QWebEngineHistory::itemAt(int i) const

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

QList<QWebEngineHistoryItem> QWebEngineHistory::items() const

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

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