QWebEngineHistory Class
La classe QWebEngineHistory représente l'historique d'une page de moteur web. Plus d'informations...
| En-tête : | #include <QWebEngineHistory> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake : | QT += webenginecore |
| En QML : | WebEngineHistory |
| Héritages : | QObject |
Propriétés
- backItems : QWebEngineHistoryModel* const
- forwardItems : QWebEngineHistoryModel* const
- items : QWebEngineHistoryModel* const
Fonctions publiques
| 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 |
Non-membres apparentés
| QDataStream & | operator<<(QDataStream &stream, const QWebEngineHistory &history) |
| QDataStream & | operator>>(QDataStream &stream, QWebEngineHistory &history) |
Description détaillée
Chaque page du moteur web contient un historique des pages visitées, accessible par QWebEnginePage::history().
L'historique utilise le concept d'élément courant, divisant les pages visitées en pages qui peuvent être visitées en naviguant en avant et en arrière à l'aide des fonctions back() et forward(). L'élément courant peut être obtenu en appelant currentItem(), et un élément arbitraire de l'historique peut devenir l'élément courant en le passant à goToItem().
Une liste d'éléments décrivant les pages qui peuvent être visitées en revenant en arrière peut être obtenue en appelant la fonction backItems() ; de même, les éléments décrivant les pages précédant la page actuelle peuvent être obtenus avec la fonction forwardItems(). La liste totale des éléments est obtenue à l'aide de la fonction items().
Les objets suivants du modèle de données QWebEngineHistoryModel sont également fournis :
backItemsModel()qui contient les URL des pages visitées.forwardItemsModel()qui contient les URL des pages visitées, qui contient les URL des pages qui ont été visitées après avoir visité la page actuelle.itemsModel()L'objet de modèle de données "page en cours", qui contient les URL des éléments Précédent et Suivant, ainsi que l'URL de la page en cours.
Comme pour les conteneurs, il existe des fonctions permettant d'examiner l'historique sous la forme d'une liste. Des éléments arbitraires de l'historique peuvent être obtenus avec itemAt(), le nombre total d'éléments est donné par count(), et l'historique peut être effacé avec la fonction clear().
L'état de QWebEngineHistory peut être sauvegardé sur QDataStream à l'aide de l'opérateur >> et chargé à l'aide de l'opérateur <<.
Voir également QWebEngineHistoryItem et QWebEnginePage.
Documentation sur les propriétés
[read-only] backItems : QWebEngineHistoryModel* const
Cette propriété contient un modèle contenant les éléments de l'historique.
Fonctions d'accès :
| QWebEngineHistoryModel * | backItemsModel() const |
Voir également items et forwardItems.
[read-only] forwardItems : QWebEngineHistoryModel* const
Cette propriété contient un modèle contenant les éléments de l'historique à terme.
Fonctions d'accès :
| QWebEngineHistoryModel * | forwardItemsModel() const |
Voir également items et backItems.
[read-only] items : QWebEngineHistoryModel* const
Cette propriété contient un modèle contenant tous les éléments de l'historique.
Fonctions d'accès :
| QWebEngineHistoryModel * | itemsModel() const |
Voir également backItems et forwardItems.
Documentation des fonctions membres
void QWebEngineHistory::back()
Définit l'élément actuel comme étant l'élément précédent de l'historique et va à la page correspondante ; c'est-à-dire qu'il revient en arrière d'un élément de l'historique.
Voir également forward() et goToItem().
QWebEngineHistoryItem QWebEngineHistory::backItem() const
Renvoie l'élément précédant l'élément actuel dans l'historique.
QList<QWebEngineHistoryItem> QWebEngineHistory::backItems(int maxItems) const
Renvoie la liste des éléments de la liste de l'historique rétrospectif. Un maximum de maxItems entrées est retourné.
Voir aussi forwardItems().
QWebEngineHistoryModel *QWebEngineHistory::backItemsModel() const
Renvoie le modèle de données qui représente les URL des pages visitées.
Remarque : fonction Getter pour la propriété backItems.
bool QWebEngineHistory::canGoBack() const
Renvoie true s'il existe un élément précédant l'élément actuel dans l'historique ; sinon, renvoie false.
Voir aussi canGoForward().
bool QWebEngineHistory::canGoForward() const
Renvoie true si nous disposons d'un élément vers lequel avancer ; sinon, renvoie false.
Voir aussi canGoBack().
[invokable] void QWebEngineHistory::clear()
Efface l'historique.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également count() et items().
int QWebEngineHistory::count() const
Renvoie le nombre total d'éléments dans l'historique.
QWebEngineHistoryItem QWebEngineHistory::currentItem() const
Renvoie l'élément actuel de l'historique.
int QWebEngineHistory::currentItemIndex() const
Renvoie l'index de l'élément actuel dans l'historique.
void QWebEngineHistory::forward()
Définit l'élément actuel comme l'élément suivant de l'historique et va à la page correspondante, c'est-à-dire qu'il avance d'un élément de l'historique.
Voir également back() et goToItem().
QWebEngineHistoryItem QWebEngineHistory::forwardItem() const
Renvoie l'élément qui suit l'élément actuel dans l'historique.
QList<QWebEngineHistoryItem> QWebEngineHistory::forwardItems(int maxItems) const
Renvoie la liste des éléments de la liste de l'historique. Un maximum de maxItems entrées est renvoyé.
Voir aussi backItems().
QWebEngineHistoryModel *QWebEngineHistory::forwardItemsModel() const
Renvoie le modèle de données qui représente les URL des pages qui ont été visitées après la page actuelle.
Remarque : fonction Getter pour la propriété forwardItems.
void QWebEngineHistory::goToItem(const QWebEngineHistoryItem &item)
Définit l'élément en cours comme étant l'élément spécifié item dans l'historique et va à la page.
Voir aussi back() et forward().
QWebEngineHistoryItem QWebEngineHistory::itemAt(int i) const
Renvoie l'élément à l'index i dans l'historique.
QList<QWebEngineHistoryItem> QWebEngineHistory::items() const
Renvoie une liste de tous les éléments figurant actuellement dans l'historique.
Voir aussi count() et clear().
QWebEngineHistoryModel *QWebEngineHistory::itemsModel() const
Renvoie le modèle de données qui représente les URL des éléments précédents, des éléments suivants et de l'élément actuel dans l'historique.
Remarque : fonction Getter pour la propriété items.
Non-membres associés
QDataStream &operator<<(QDataStream &stream, const QWebEngineHistory &history)
Enregistre l'historique du moteur web history dans stream.
QDataStream &operator>>(QDataStream &stream, QWebEngineHistory &history)
Charge l'historique du moteur web de stream à history.
© 2026 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.
