QWebEngineHistory类
QWebEngineHistory类表示一个网页引擎页面的历史。 更多...
| 头文件 | #include <QWebEngineHistory> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore) target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake | QT += webenginecore |
| 由以下类实例化 | WebEngineHistory |
| 继承 | QObject |
公共函数
| 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 |
相关非成员
| QDataStream & | operator<<(QDataStream &stream, const QWebEngineHistory &history) |
| QDataStream & | operator>>(QDataStream &stream, QWebEngineHistory &history) |
详细描述
每个网页引擎页面包含一个访问过的页面历史记录，可以通过QWebEnginePage::history()访问。
历史记录使用“当前项”的概念，将访问过的页面分为可以通过back()和forward()函数导航的“后退”和“前进”页面。可以通过调用currentItem()获取当前项，通过传递到goToItem()的任意历史记录项将其设置为当前项。
通过调用backItems()函数，可以获取可以通过后退访问的页面列表；同样，通过调用forwardItems()函数，可以获取当前页面之前的页面列表。使用items()函数可以获得项目总数列表。
此外，还提供了以下QWebEngineHistoryModel数据模型对象：
backItemsModel()，其中包含已访问页面的URL。forwardItemsModel()，其中包含浏览当前页面之后访问的页面的URL。itemsModel()，其中包含后退和前进项的URL以及当前页面的URL。
与容器一样，功能允许按列表方式检查历史记录。可以使用itemAt()获取历史记录中的任意项，项目总数由count()给出，并且可以使用clear()函数清除历史记录。
可以使用>>运算符将QWebEngineHistory的状态保存到QDataStream，并使用<<运算符进行加载。
另请参阅QWebEngineHistoryItem和QWebEnginePage。
成员函数文档
void QWebEngineHistory::back()
将当前项设置为历史中的前一项，并跳转到相应的页面；也就是说，后退一个历史项目。
QWebEngineHistoryItem QWebEngineHistory::backItem() const
返回历史记录中当前项之前的项目。
QList<QWebEngineHistoryItem> QWebEngineHistory::backItems(int maxItems) const
返回后退历史列表中的项目列表。最多返回maxItems条条目。
另请参阅forwardItems。
QWebEngineHistoryModel *QWebEngineHistory::backItemsModel() const
返回数据模型，表示已访问页面的URL。
注意：这是backItems属性的获取器函数。
bool QWebEngineHistory::canGoBack() const
如果历史记录中存在一个位于当前项之前的项目，则返回true；否则返回false。
另请参阅canGoForward。
bool QWebEngineHistory::canGoForward() const
如果有要前进的项目，则返回true；否则返回false。
另请参阅canGoBack。
[可调用] void QWebEngineHistory::clear()
清除历史记录。
注意：此函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE。
int QWebEngineHistory::count() const
获取历史记录中的项目总数。
QWebEngineHistoryItem QWebEngineHistory::currentItem() const
返回历史记录中的当前项目。
int QWebEngineHistory::currentItemIndex() const
返回历史记录中当前项目的索引。
void QWebEngineHistory::forward()
将当前项目设置为历史记录中的下一个项目，并跳转到相应的页面；即向前移动一个历史项目。
QWebEngineHistoryItem QWebEngineHistory::forwardItem() const
返回历史记录中当前项目之后的项目。
QList<QWebEngineHistoryItem> QWebEngineHistory::forwardItems(int maxItems) const
返回前向历史项目列表中的项目列表。最多返回 maxItems 条记录。
另请参阅backItems。
QWebEngineHistoryModel *QWebEngineHistory::forwardItemsModel() const
返回数据模型，表示在访问当前页面之后的页面URL。
注意：属性 forwardItems 的获取函数。
void QWebEngineHistory::goToItem(const QWebEngineHistoryItem &item)
将当前项目设置为历史记录中的指定 item，并跳转到页面。
QWebEngineHistoryItem QWebEngineHistory::itemAt(int i) const
返回历史记录中索引为 i 的项目。
QList<QWebEngineHistoryItem> QWebEngineHistory::items() const
返回历史记录中所有当前项目的列表。
QWebEngineHistoryModel *QWebEngineHistory::itemsModel() const
返回数据模型，表示历史记录中的后退项目、前向项目和当前项目。
注意：属性 items 的获取函数。
相关非成员函数
QDataStream &operator<<(QDataStream &stream, const QWebEngineHistory &history)
将网络引擎历史记录 history 保存到 stream 中。
QDataStream &operator>>(QDataStream &stream, QWebEngineHistory &history)
从流中加载Web引擎历史记录到历史记录。
© 2024 Qt公司。本文件中包含的文档贡献是非各自所有者的版权。本文件提供的文档受GNU自由文档许可证版本1.3的许可，该许可证由自由软件基金会发布。Qt及其相关标志是芬兰及其它国家/地区的Qt公司商标。商标所有者保留所有其他商标权利。
