PySide6.QtWebEngineCore.QWebEngineHistory¶

class QWebEngineHistory¶

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

概要¶

属性¶

backItemsᅟ
forwardItemsᅟ
itemsᅟ

方法¶

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

注意

本文档可能包含从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 中，并使用 << 操作符加载。

另请参阅

QWebEngineHistoryItem QWebEnginePage

注意

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

property backItemsᅟ: QWebEngineHistoryModel¶

Access functions:

backItemsModel()

property forwardItemsᅟ: QWebEngineHistoryModel¶

Access functions:

forwardItemsModel()

property itemsᅟ: QWebEngineHistoryModel¶

Access functions:

itemsModel()

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ᅟ 的获取器。