Класс 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().