QWebEngineHistory¶

The QWebEngineHistory class represents the history of a web engine page. More…

Synopsis¶

Functions¶

def back ()
def backItem ()
def backItems (maxItems)
def canGoBack ()
def canGoForward ()
def clear ()
def count ()
def currentItem ()
def currentItemIndex ()
def forward ()
def forwardItem ()
def forwardItems (maxItems)
def goToItem (item)
def itemAt (i)
def items ()

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.

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

QWebEngineHistoryItem QWebEnginePage

class PySide2.QtWebEngineWidgets.QWebEngineHistory¶

PySide2.QtWebEngineWidgets.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

forward() goToItem()

PySide2.QtWebEngineWidgets.QWebEngineHistory.backItem()¶

Return type:: PySide2.QtWebEngineWidgets.QWebEngineHistoryItem

Returns the item before the current item in the history.

PySide2.QtWebEngineWidgets.QWebEngineHistory.backItems(maxItems)¶

Parameters:: maxItems – int
Return type:

Returns the list of items in the backwards history list. At most maxItems entries are returned.

See also

forwardItems()

PySide2.QtWebEngineWidgets.QWebEngineHistory.canGoBack()¶

Return type:: bool

Returns true if there is an item preceding the current item in the history; otherwise returns false .

See also

canGoForward()

PySide2.QtWebEngineWidgets.QWebEngineHistory.canGoForward()¶

Return type:: bool

Returns true if we have an item to go forward to; otherwise returns false .

See also

canGoBack()

PySide2.QtWebEngineWidgets.QWebEngineHistory.clear()¶: Clears the history.

See also

count() items()

PySide2.QtWebEngineWidgets.QWebEngineHistory.count()¶

Return type:: int

Returns the total number of items in the history.

PySide2.QtWebEngineWidgets.QWebEngineHistory.currentItem()¶

Return type:: PySide2.QtWebEngineWidgets.QWebEngineHistoryItem

Returns the current item in the history.

PySide2.QtWebEngineWidgets.QWebEngineHistory.currentItemIndex()¶

Return type:: int

Returns the index of the current item in history.

PySide2.QtWebEngineWidgets.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

back() goToItem()