QWebEngineHistory#
The QWebEngineHistory class represents the history of a web engine page. More…
Synopsis#
Properties#
Functions#
def
back()def
backItem()def
backItems(maxItems)def
backItemsModel()def
canGoBack()def
canGoForward()def
clear()def
count()def
currentItem()def
currentItemIndex()def
forward()def
forwardItem()def
forwardItems(maxItems)def
forwardItemsModel()def
goToItem(item)def
itemAt(i)def
items()def
itemsModel()
Note
This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE
Detailed Description#
Each web engine page contains a history of visited pages that can be accessed by history() .
The history uses the concept of a current item, dividing the pages visited into those that can be visited by navigating back and forward using the back() and forward() functions. The current item can be obtained by calling currentItem() , and an arbitrary item in the history can be made the current item by passing it to goToItem() .
A list of items describing the pages that can be visited by going back can be obtained by calling the backItems() function; similarly, items describing the pages ahead of the current page can be obtained with the forwardItems() function. The total list of items is obtained with the items() function.
Also, the following QWebEngineHistoryModel data model objects are provided:
backItemsModel(), which contains the URLs of visited pages.
forwardItemsModel(), which contains the URLs of the pages that were visited after visiting the current page.
itemsModel(), which contains the URLs of the back and forward items, as well as the URL of the current page.
Just as with containers, functions are available to examine the history in terms of a list. Arbitrary items in the history can be obtained with itemAt() , the total number of items is given by count() , and the history can be cleared with the clear() function.
QWebEngineHistory ‘s state can be saved to a QDataStream using the >> operator and loaded by using the << operator.
See also
- class PySide6.QtWebEngineCore.QWebEngineHistory#
Note
Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.
- property PᅟySide6.QtWebEngineCore.QWebEngineHistory.backItems: PySide6.QtWebEngineCore.QWebEngineHistoryModel#
- Access functions:
- property PᅟySide6.QtWebEngineCore.QWebEngineHistory.forwardItems: PySide6.QtWebEngineCore.QWebEngineHistoryModel#
- Access functions:
- property PᅟySide6.QtWebEngineCore.QWebEngineHistory.items: PySide6.QtWebEngineCore.QWebEngineHistoryModel#
- Access functions:
itemsModel()
- PySide6.QtWebEngineCore.QWebEngineHistory.back()#
Sets the current item to be the previous item in the history and goes to the corresponding page; that is, goes back one history item.
See also
- PySide6.QtWebEngineCore.QWebEngineHistory.backItem()#
- Return type:
Returns the item before the current item in the history.
- PySide6.QtWebEngineCore.QWebEngineHistory.backItems(maxItems)#
- Parameters:
maxItems – int
- Return type:
.list of QWebEngineHistoryItem
Returns the list of items in the backwards history list. At most maxItems entries are returned.
See also
- PySide6.QtWebEngineCore.QWebEngineHistory.backItemsModel()#
- Return type:
Return the data model, which represents URLs of visited pages.
Getter of property backItems .
- PySide6.QtWebEngineCore.QWebEngineHistory.canGoBack()#
- Return type:
bool
Returns true if there is an item preceding the current item in the history; otherwise returns false.
See also
- PySide6.QtWebEngineCore.QWebEngineHistory.canGoForward()#
- Return type:
bool
Returns true if we have an item to go forward to; otherwise returns false.
See also
- PySide6.QtWebEngineCore.QWebEngineHistory.clear()#
Clears the history.
- PySide6.QtWebEngineCore.QWebEngineHistory.count()#
- Return type:
int
Returns the total number of items in the history.
- PySide6.QtWebEngineCore.QWebEngineHistory.currentItem()#
- Return type:
Returns the current item in the history.
- PySide6.QtWebEngineCore.QWebEngineHistory.currentItemIndex()#
- Return type:
int
Returns the index of the current item in history.
- PySide6.QtWebEngineCore.QWebEngineHistory.forward()#
Sets the current item to be the next item in the history and goes to the corresponding page; that is, goes forward one history item.
See also
- PySide6.QtWebEngineCore.QWebEngineHistory.forwardItem()#
- Return type:
Returns the item after the current item in the history.
- PySide6.QtWebEngineCore.QWebEngineHistory.forwardItems(maxItems)#
- Parameters:
maxItems – int
- Return type:
.list of QWebEngineHistoryItem
Returns the list of items in the forward history list. At most maxItems entries are returned.
See also
- PySide6.QtWebEngineCore.QWebEngineHistory.forwardItemsModel()#
- Return type:
Return the data model, which represents URLs of the pages that were visited after visiting the current page.
Getter of property forwardItems .
- PySide6.QtWebEngineCore.QWebEngineHistory.goToItem(item)#
- Parameters:
Sets the current item to be the specified item in the history and goes to the page.
- PySide6.QtWebEngineCore.QWebEngineHistory.itemAt(i)#
- Parameters:
i – int
- Return type:
Returns the item at index i in the history.
- PySide6.QtWebEngineCore.QWebEngineHistory.items()#
- Return type:
.list of QWebEngineHistoryItem
Returns a list of all items currently in the history.
- PySide6.QtWebEngineCore.QWebEngineHistory.itemsModel()#
- Return type:
Returns the data model, which represents URLs of back items, forward items, and the current item in the history.
Getter of property items .