Qt 4.8: QWebHistoryItem Class Reference

Qt Reference Documentation

# QWebHistoryItem Class Reference

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

     #include <QWebHistoryItem>

This class was introduced in Qt 4.4.

- List of all members, including inherited members

## Public Functions

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

## 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.

Function | Description
--- | ---
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(), and QWebHistoryInterface.

## Member Function 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.

### QIcon QWebHistoryItem::icon () const

Returns the icon associated with the history item.

See also title(), url(), and lastVisited().

### bool QWebHistoryItem::isValid () const

Returns whether this is a valid history item.

This function was introduced in Qt 4.5.

### QDateTime QWebHistoryItem::lastVisited () const

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

See also title(), icon(), and url().

### 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.

This function was introduced in Qt 4.5.

See also userData().

### QString QWebHistoryItem::title () const

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

See also icon(), url(), and lastVisited().

### QUrl QWebHistoryItem::url () const

Returns the URL associated with the history item.

See also originalUrl(), title(), and lastVisited().

### QVariant QWebHistoryItem::userData () const

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

This function was introduced in Qt 4.5.

See also setUserData().

### 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.