QWebEngineHistory Class
Die Klasse QWebEngineHistory stellt die Historie einer Web-Engine-Seite dar. Mehr...
| Kopfzeile: | #include <QWebEngineHistory> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| In QML: | WebEngineHistory |
| Vererbt: | QObject |
Öffentliche Funktionen
| void | back() |
| QWebEngineHistoryItem | backItem() const |
| QList<QWebEngineHistoryItem> | backItems(int maxItems) const |
| QWebEngineHistoryModel * | backItemsModel() const |
| bool | canGoBack() const |
| bool | canGoForward() const |
| void | clear() |
| int | count() const |
| QWebEngineHistoryItem | currentItem() const |
| int | currentItemIndex() const |
| void | forward() |
| QWebEngineHistoryItem | forwardItem() const |
| QList<QWebEngineHistoryItem> | forwardItems(int maxItems) const |
| QWebEngineHistoryModel * | forwardItemsModel() const |
| void | goToItem(const QWebEngineHistoryItem &item) |
| QWebEngineHistoryItem | itemAt(int i) const |
| QList<QWebEngineHistoryItem> | items() const |
| QWebEngineHistoryModel * | itemsModel() const |
Verwandte Nicht-Members
| QDataStream & | operator<<(QDataStream &stream, const QWebEngineHistory &history) |
| QDataStream & | operator>>(QDataStream &stream, QWebEngineHistory &history) |
Detaillierte Beschreibung
Jede Seite der Web-Engine enthält eine Historie der besuchten Seiten, auf die mit QWebEnginePage::history() zugegriffen werden kann.
Die Historie verwendet das Konzept eines aktuellen Elements, das die besuchten Seiten in solche unterteilt, die durch Vor- und Zurücknavigieren mit den Funktionen back() und forward() besucht werden können. Das aktuelle Element kann durch den Aufruf von currentItem() ermittelt werden, und ein beliebiges Element in der Historie kann zum aktuellen Element gemacht werden, indem es an goToItem() übergeben wird.
Eine Liste von Elementen, die die Seiten beschreiben, die durch Zurückgehen besucht werden können, erhält man durch Aufruf der Funktion backItems(); ebenso können Elemente, die die Seiten vor der aktuellen Seite beschreiben, mit der Funktion forwardItems() erhalten werden. Die Gesamtliste der Elemente erhält man mit der Funktion items().
Außerdem werden die folgenden QWebEngineHistoryModel Datenmodellobjekte bereitgestellt:
backItemsModel(), das die URLs der besuchten Seiten enthält.forwardItemsModel(), die die URLs der Seiten enthält, die nach dem Besuch der aktuellen Seite besucht wurden.itemsModel()Die URLs der Seiten, die nach dem Besuch der aktuellen Seite besucht wurden, sowie die URL der aktuellen Seite.
Wie bei den Containern stehen Funktionen zur Verfügung, um die Historie in Form einer Liste zu untersuchen. Beliebige Elemente in der Historie können mit itemAt() ermittelt werden, die Gesamtzahl der Elemente wird mit count() angegeben, und die Historie kann mit der Funktion clear() geleert werden.
Der Zustand von QWebEngineHistory kann mit dem Operator >> auf QDataStream gespeichert und mit dem Operator << geladen werden.
Siehe auch QWebEngineHistoryItem und QWebEnginePage.
Dokumentation der Mitgliedsfunktionen
void QWebEngineHistory::back()
Setzt den aktuellen Eintrag auf den vorherigen Eintrag in der Historie und wechselt zur entsprechenden Seite, d. h. geht einen Eintrag in der Historie zurück.
Siehe auch forward() und goToItem().
QWebEngineHistoryItem QWebEngineHistory::backItem() const
Gibt das Element vor dem aktuellen Element in der Historie zurück.
QList<QWebEngineHistoryItem> QWebEngineHistory::backItems(int maxItems) const
Gibt die Liste der Einträge in der rückwärtsgerichteten Verlaufsliste zurück. Es werden höchstens maxItems Einträge zurückgegeben.
Siehe auch forwardItems().
QWebEngineHistoryModel *QWebEngineHistory::backItemsModel() const
Gibt das Datenmodell zurück, das die URLs der besuchten Seiten darstellt.
Hinweis: Getter-Funktion für die Eigenschaft backItems.
bool QWebEngineHistory::canGoBack() const
Gibt true zurück, wenn es in der Historie ein Element gibt, das dem aktuellen Element vorausgeht; andernfalls wird false zurückgegeben.
Siehe auch canGoForward().
bool QWebEngineHistory::canGoForward() const
Gibt true zurück, wenn wir ein Element haben, zu dem wir weitergehen können; andernfalls wird false zurückgegeben.
Siehe auch canGoBack().
[invokable] void QWebEngineHistory::clear()
Löscht die Historie.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch count() und items().
int QWebEngineHistory::count() const
Gibt die Gesamtzahl der Einträge in der Historie zurück.
QWebEngineHistoryItem QWebEngineHistory::currentItem() const
Gibt den aktuellen Eintrag in der Historie zurück.
int QWebEngineHistory::currentItemIndex() const
Gibt den Index des aktuellen Eintrags in der Historie zurück.
void QWebEngineHistory::forward()
Legt den aktuellen Eintrag als nächsten Eintrag in der Historie fest und wechselt zur entsprechenden Seite, d. h. geht einen Eintrag in der Historie weiter.
Siehe auch back() und goToItem().
QWebEngineHistoryItem QWebEngineHistory::forwardItem() const
Gibt das Element nach dem aktuellen Element in der Historie zurück.
QList<QWebEngineHistoryItem> QWebEngineHistory::forwardItems(int maxItems) const
Gibt die Liste der Einträge in der Vorwärts-Historienliste zurück. Es werden höchstens maxItems Einträge zurückgegeben.
Siehe auch backItems().
QWebEngineHistoryModel *QWebEngineHistory::forwardItemsModel() const
Gibt das Datenmodell zurück, das die URLs der Seiten darstellt, die nach dem Besuch der aktuellen Seite besucht wurden.
Hinweis: Getter-Funktion für die Eigenschaft forwardItems.
void QWebEngineHistory::goToItem(const QWebEngineHistoryItem &item)
Setzt das aktuelle Element auf die angegebene item in der Historie und wechselt zu dieser Seite.
Siehe auch back() und forward().
QWebEngineHistoryItem QWebEngineHistory::itemAt(int i) const
Gibt das Element mit dem Index i in der Historie zurück.
QList<QWebEngineHistoryItem> QWebEngineHistory::items() const
Gibt eine Liste aller Einträge zurück, die sich derzeit in der Historie befinden.
Siehe auch count() und clear().
QWebEngineHistoryModel *QWebEngineHistory::itemsModel() const
Gibt das Datenmodell zurück, das die URLs der zurückliegenden Elemente, der vorwärtsgerichteten Elemente und des aktuellen Elements in der Historie darstellt.
Hinweis: Getter-Funktion für die Eigenschaft items.
Verwandte Nicht-Mitglieder
QDataStream &operator<<(QDataStream &stream, const QWebEngineHistory &history)
Speichert den Suchmaschinenverlauf history in stream.
QDataStream &operator>>(QDataStream &stream, QWebEngineHistory &history)
Lädt den Suchmaschinenverlauf von stream in history.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
