CopperSpice API  1.7.2
QWebHistoryItem Class Reference

The QWebHistoryItem class represents one item in the history of a QWebPage. More...

Public Methods

 QWebHistoryItem (const QWebHistoryItem &other)
 
 ~QWebHistoryItem ()
 
QIcon icon () const
 
bool isValid () const
 
QDateTime lastVisited () const
 
QWebHistoryItem & operator= (const QWebHistoryItem &other)
 
QUrl originalUrl () const
 
void setUserData (const QVariant &userData)
 
QString title () const
 
QUrl url () const
 
QVariant userData () const
 

Friends

class QWebHistory
 
class QWebPage
 

Detailed Description

The QWebHistoryItem class represents one item in the history of a QWebPage

Each QWebHistoryItem instance represents an entry in the history stack of a Web page, containing information about the page, its location, and when it was last visited.

The following table shows the properties of the page held by the history item, and the functions used to access them.

FunctionDescription
title()The page title.
url()The location of the page.
originalUrl()The URL used to access the page.
lastVisited()The date and time of the user's last visit to the page.
icon()The icon associated with the page that was provided by the server.
userData()The user specific data that was stored with the history item.
Note
QWebHistoryItem objects are value based, but explicitly shared. Changing a QWebHistoryItem instance by calling setUserData() will change all copies of that instance.
See also
QWebHistory, QWebPage::history(), QWebHistoryInterface

Constructor & Destructor Documentation

QWebHistoryItem::QWebHistoryItem ( const QWebHistoryItem &  other)

Constructs a history item from other. The new item and other will share their data, and modifying either this item or other will modify both instances.

QWebHistoryItem::~QWebHistoryItem ( )

Destroys the history item.

Method Documentation

QIcon QWebHistoryItem::icon ( ) const

Returns the icon associated with the history item.

See also
title(), url(), lastVisited()
bool QWebHistoryItem::isValid ( ) const

Returns whether this is a valid history item.

QDateTime QWebHistoryItem::lastVisited ( ) const

Returns the date and time that the page associated with the item was last visited.

See also
title(), icon(), url()
QWebHistoryItem & QWebHistoryItem::operator= ( const QWebHistoryItem &  other)

Assigns the other history item to this. This item and other will share their data, and modifying either this item or other will modify both instances.

QUrl QWebHistoryItem::originalUrl ( ) const

Returns the original URL associated with the history item.

See also
url()
void QWebHistoryItem::setUserData ( const QVariant userData)

Stores user specific data userData with the history item.

Note
All copies of this item will be modified.
See also
userData()
QString QWebHistoryItem::title ( ) const

Returns the title of the page associated with the history item.

See also
icon(), url(), lastVisited()
QUrl QWebHistoryItem::url ( ) const

Returns the URL associated with the history item.

See also
originalUrl(), title(), lastVisited()
QVariant QWebHistoryItem::userData ( ) const

Returns the user specific data that was stored with the history item.

See also
setUserData()