class QWebEngineHistory#

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

摘要#

属性#

backItemsᅟ
forwardItemsᅟ
itemsᅟ

方法#

定义 back()
定义 backItem()
定义 backItems()
定义 backItemsModel()
定义 canGoBack()
定义 canGoForward()
定义 clear()
定义 count()
定义 currentItem()
定义 currentItemIndex()
定义 forward()
定义 forwardItem()
定义 forwardItems()
定义 forwardItemsModel()
定义 goToItem()
定义 itemAt()
定义 items()
定义 itemsModel()

注意

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

详细描述#

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

历史使用“当前项”这一概念，将访问的页面分为可以通过使用 backward() 和 forward() 函数进行导航的页面。可以通过调用 currentItem() 获取当前项，并将历史中的任意项设置为当前项，方法是将它传递给 goToItem()。

可以通过调用 backItems() 函数获取一个描述可以后退访问的页面的项的列表；同样，可以使用 forwardItems() 函数获取描述当前页面之后的页面的项。总项列表可以通过调用 items() 函数获得。

还提供了以下 QWebEngineHistoryModel 数据模型对象：

backItemsModel()，其中包含已访问页面的 URL。

forwardItemsModel()，其中包含在当前页面之后访问的页面的 URL。

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

与容器类似，可以通过列表来检查历史。可以使用 itemAt() 获取历史中的任意项，使用 count() 获取项的总数，并使用 clear() 函数清除历史。

可以使用 >> 运算符将 QWebEngineHistory 的状态保存到 QDataStream 中，并使用 << 运算符加载。

另请参阅

QWebEngineHistoryItem 和 QWebEnginePage

注意

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

属性 backItems: QWebEngineHistoryModel#

访问函数

backItemsModel()

属性 forwardItems: QWebEngineHistoryModel#

访问函数

forwardItemsModel()

属性 items: QWebEngineHistoryModel#

访问函数

itemsModel()

back()#

将当前项目设置为历史中的上一项目，跳转到对应的页面；即后退一个历史项目。

另请参阅

forward() goToItem()

backItem()#

返回类型:: QWebEngineHistoryItem

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

backItems(maxItems)#

参数:: maxItems – int
返回类型:: . QWebEngineHistoryItem 列表

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

另请参阅

forwardItems()

backItemsModel()#

返回类型:: QWebEngineHistoryModel

返回数据模型，表示已访问页面的URL。

属性 backItems 的获取器。

canGoBack()#

返回类型:: bool

如果历史中存在当前项目之前的项目，则返回 true；否则返回 false。

另请参阅

canGoForward()

canGoForward()#

返回类型:: bool

如果我们可以向前移动到下一项，则返回 true；否则返回 false。

另请参阅

canGoBack()

clear()#

清除历史记录。

另请参阅

count() items()

count()#

返回类型:: int

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

currentItem()#

返回类型:: QWebEngineHistoryItem

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

currentItemIndex()#

返回类型:: int

返回当前项在历史中的索引。

forward()#

将当前项设置为历史中的下一项，并转到相应的页面；即向前移动一个历史项。

另请参阅

back() goToItem()

forwardItem()#

返回类型:: QWebEngineHistoryItem

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

forwardItems(maxItems)#

参数:: maxItems – int
返回类型:: . QWebEngineHistoryItem 列表

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

另请参阅

backItems()

forwardItemsModel()#

返回类型:: QWebEngineHistoryModel

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

属性 forwardItems 的获取器。

goToItem(item)#

参数:: item – QWebEngineHistoryItem

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

另请参阅

back() forward()

itemAt(i)#

参数:: i – int
返回类型:: QWebEngineHistoryItem

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

items()#

返回类型:: . QWebEngineHistoryItem 列表

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

另请参阅

count() clear()

itemsModel()#

返回类型:: QWebEngineHistoryModel

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

属性 itemsᅟ 的获取器。