QWebEngineHistory Class
La clase QWebEngineHistory representa la historia de una página del motor web. Más...
| Cabecera: | #include <QWebEngineHistory> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| En QML: | WebEngineHistory |
| Hereda: | QObject |
Propiedades
- backItems : QWebEngineHistoryModel* const
- forwardItems : QWebEngineHistoryModel* const
- items : QWebEngineHistoryModel* const
Funciones públicas
| 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 |
Relacionados No Miembros
| QDataStream & | operator<<(QDataStream &stream, const QWebEngineHistory &history) |
| QDataStream & | operator>>(QDataStream &stream, QWebEngineHistory &history) |
Descripción detallada
Cada página del motor web contiene un historial de páginas visitadas al que se puede acceder mediante QWebEnginePage::history().
El historial utiliza el concepto de ítem actual, dividiendo las páginas visitadas en aquellas que pueden visitarse navegando hacia atrás y hacia delante mediante las funciones back() y forward(). El elemento actual puede obtenerse llamando a currentItem(), y un elemento arbitrario del historial puede convertirse en el elemento actual pasándolo a goToItem().
Una lista de elementos que describen las páginas que pueden visitarse volviendo atrás puede obtenerse llamando a la función backItems(); de forma similar, los elementos que describen las páginas anteriores a la página actual pueden obtenerse con la función forwardItems(). La lista total de elementos se obtiene con la función items().
Además, se proporcionan los siguientes objetos del modelo de datos QWebEngineHistoryModel:
backItemsModel(), que contiene las URL de las páginas visitadas.forwardItemsModel(), que contiene las URL de las páginas que se visitaron después de visitar la página actual.itemsModel(), que contiene las URL de los elementos atrás y adelante, así como la URL de la página actual.
Al igual que con los contenedores, existen funciones para examinar el historial en forma de lista. Los elementos arbitrarios del historial pueden obtenerse con itemAt(), el número total de elementos viene dado por count(), y el historial puede borrarse con la función clear().
El estado de QWebEngineHistory puede guardarse en QDataStream utilizando el operador >> y cargarse utilizando el operador <<.
Ver también QWebEngineHistoryItem y QWebEnginePage.
Documentación de propiedades
[read-only] backItems : QWebEngineHistoryModel* const
Esta propiedad contiene un modelo con los elementos del historial.
Funciones de acceso:
| QWebEngineHistoryModel * | backItemsModel() const |
Véase también items y forwardItems.
[read-only] forwardItems : QWebEngineHistoryModel* const
Esta propiedad contiene un modelo que contiene los elementos del historial de avance.
Funciones de acceso:
| QWebEngineHistoryModel * | forwardItemsModel() const |
Véase también items y backItems.
[read-only] items : QWebEngineHistoryModel* const
Esta propiedad contiene un modelo con todos los elementos del historial.
Funciones de acceso:
| QWebEngineHistoryModel * | itemsModel() const |
Véase también backItems y forwardItems.
Documentación de las funciones miembro
void QWebEngineHistory::back()
Establece el elemento actual como el elemento anterior del historial y va a la página correspondiente; es decir, retrocede un elemento del historial.
Véase también forward() y goToItem().
QWebEngineHistoryItem QWebEngineHistory::backItem() const
Devuelve el elemento anterior al actual en el historial.
QList<QWebEngineHistoryItem> QWebEngineHistory::backItems(int maxItems) const
Devuelve la lista de elementos de la lista del historial hacia atrás. Se devuelven como máximo maxItems entradas.
Véase también forwardItems().
QWebEngineHistoryModel *QWebEngineHistory::backItemsModel() const
Devuelve el modelo de datos que representa las URL de las páginas visitadas.
Nota: Función Getter para la propiedad backItems.
bool QWebEngineHistory::canGoBack() const
Devuelve true si hay un elemento anterior al actual en el historial; en caso contrario devuelve false.
Véase también canGoForward().
bool QWebEngineHistory::canGoForward() const
Devuelve true si tenemos un elemento al que avanzar; en caso contrario devuelve false.
Véase también canGoBack().
[invokable] void QWebEngineHistory::clear()
Borra el historial.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también count() y items().
int QWebEngineHistory::count() const
Devuelve el número total de elementos del historial.
QWebEngineHistoryItem QWebEngineHistory::currentItem() const
Devuelve el elemento actual del historial.
int QWebEngineHistory::currentItemIndex() const
Devuelve el índice del elemento actual en el historial.
void QWebEngineHistory::forward()
Establece el elemento actual como siguiente elemento del historial y pasa a la página correspondiente; es decir, avanza un elemento del historial.
Véase también back() y goToItem().
QWebEngineHistoryItem QWebEngineHistory::forwardItem() const
Devuelve el elemento posterior al actual en el historial.
QList<QWebEngineHistoryItem> QWebEngineHistory::forwardItems(int maxItems) const
Devuelve la lista de elementos de la lista del historial de avance. Se devuelven como máximo maxItems entradas.
Véase también backItems().
QWebEngineHistoryModel *QWebEngineHistory::forwardItemsModel() const
Devuelve el modelo de datos, que representa las URLs de las páginas que fueron visitadas después de visitar la página actual.
Nota: Función Getter para la propiedad forwardItems.
void QWebEngineHistory::goToItem(const QWebEngineHistoryItem &item)
Establece el elemento actual como el item especificado en el historial y va a la página.
Véase también back() y forward().
QWebEngineHistoryItem QWebEngineHistory::itemAt(int i) const
Devuelve el elemento en el índice i en el historial.
QList<QWebEngineHistoryItem> QWebEngineHistory::items() const
Devuelve una lista de todos los elementos actualmente en el historial.
Véase también count() y clear().
QWebEngineHistoryModel *QWebEngineHistory::itemsModel() const
Devuelve el modelo de datos, que representa las direcciones URL de los elementos anteriores, los elementos posteriores y el elemento actual del historial.
Nota: Función Getter para la propiedad items.
No miembros relacionados
QDataStream &operator<<(QDataStream &stream, const QWebEngineHistory &history)
Guarda el historial del motor web history en stream.
QDataStream &operator>>(QDataStream &stream, QWebEngineHistory &history)
Carga el historial del motor web de stream en 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.
