PySide6.QtWebEngineCore.QWebEngineHistory

class QWebEngineHistory

QWebEngineHistory 类表示网页引擎页面的历史记录。更多

PySide6.QtWebEngineCore.QWebEngineHistory 的继承图

概要

属性

方法

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

每个网页引擎页面都包含一个访问过的页面历史记录,可以通过history()访问。

历史记录使用了当前项的概念,将访问的页面分为可以通过使用back()forward()函数进行后退前进导航访问的页面。当前项可以通过调用currentItem()获得,并且可以通过将任意项传递给goToItem()使其成为当前项。

可以通过调用backItems()函数获取描述可以返回访问的页面的项目列表;同样,可以通过forwardItems()函数获取描述当前页面之后的页面的项目。通过items()函数可以获取所有项目的总列表。

此外,还提供了以下QWebEngineHistoryModel数据模型对象:

  • backItemsModel(),其中包含访问过的页面的URL。

  • forwardItemsModel(),其中包含访问当前页面后访问的页面的URL。

  • itemsModel(),其中包含后退和前进项目的URL,以及当前页面的URL。

就像容器一样,有一些函数可以以列表的形式检查历史记录。可以使用itemAt()获取历史记录中的任意项目,项目总数由count()给出,并且可以使用clear()函数清除历史记录。

QWebEngineHistory 的状态可以使用 >> 操作符保存到 QDataStream 中,并使用 << 操作符加载。

注意

当使用from __feature__ import true_property时,属性可以直接使用,否则通过访问器函数使用。

property backItemsᅟ: QWebEngineHistoryModel
Access functions:
property forwardItemsᅟ: QWebEngineHistoryModel
Access functions:
property itemsᅟ: QWebEngineHistoryModel
Access functions:
back()

将当前项设置为历史记录中的前一项,并转到相应的页面;也就是说,返回一个历史记录项。

另请参阅

forward() goToItem()

backItem()
Return type:

QWebEngineHistoryItem

返回历史记录中当前项目之前的项目。

backItems(maxItems)
Parameters:

maxItems – int

Return type:

QWebEngineHistoryItem的列表

返回反向历史记录列表中的项目列表。最多返回maxItems个条目。

另请参阅

forwardItems()

backItemsModel()
Return type:

QWebEngineHistoryModel

返回数据模型,该模型表示访问页面的URL。

属性 backItemsᅟ 的获取器。

canGoBack()
Return type:

布尔

如果历史记录中当前项之前有项,则返回true;否则返回false

另请参阅

canGoForward()

canGoForward()
Return type:

布尔

如果我们有一个项目可以前进,则返回true;否则返回false

另请参阅

canGoBack()

clear()

清除历史记录。

另请参阅

count() items()

count()
Return type:

整数

返回历史记录中的项目总数。

currentItem()
Return type:

QWebEngineHistoryItem

返回历史记录中的当前项。

currentItemIndex()
Return type:

整数

返回历史记录中当前项目的索引。

forward()

将当前项设置为历史记录中的下一项,并转到相应的页面;也就是说,向前移动一个历史记录项。

另请参阅

back() goToItem()

forwardItem()
Return type:

QWebEngineHistoryItem

返回历史记录中当前项之后的项。

forwardItems(maxItems)
Parameters:

maxItems – int

Return type:

QWebEngineHistoryItem的列表

返回前进历史记录列表中的项目列表。最多返回maxItems个条目。

另请参阅

backItems()

forwardItemsModel()
Return type:

QWebEngineHistoryModel

返回数据模型,该模型表示访问当前页面后访问的页面的URL。

属性 forwardItemsᅟ 的获取器。

goToItem(item)
Parameters:

项目QWebEngineHistoryItem

将当前项目设置为历史记录中的指定item并转到页面。

另请参阅

back() forward()

itemAt(i)
Parameters:

i – 整数

Return type:

QWebEngineHistoryItem

返回历史记录中索引为 i 的项目。

items()
Return type:

QWebEngineHistoryItem的列表

返回当前历史记录中所有项目的列表。

另请参阅

count() clear()

itemsModel()
Return type:

QWebEngineHistoryModel

返回数据模型,该模型表示历史记录中后退项、前进项和当前项的URL。

属性 itemsᅟ 的获取器。