WebKitGTK+ Reference Manual: WebKitWebHistoryItem

## WebKitWebHistoryItem WebKitWebHistoryItem — One item of the WebKitWebBackForwardList and or global history |

## Synopsis

                        WebKitWebHistoryItem;
    WebKitWebHistoryItem * webkit_web_history_item_copy     (WebKitWebHistoryItem *web_history_item);
    const gchar *       webkit_web_history_item_get_alternate_title
                                                            (WebKitWebHistoryItem *web_history_item);
    gdouble             webkit_web_history_item_get_last_visited_time
                                                            (WebKitWebHistoryItem *web_history_item);
    const gchar *       webkit_web_history_item_get_original_uri
                                                            (WebKitWebHistoryItem *web_history_item);
    const gchar *       webkit_web_history_item_get_title   (WebKitWebHistoryItem *web_history_item);
    const gchar *       webkit_web_history_item_get_uri     (WebKitWebHistoryItem *web_history_item);
    WebKitWebHistoryItem * webkit_web_history_item_new      (void);
    WebKitWebHistoryItem * webkit_web_history_item_new_with_data
                                                            (const gchar *uri,
                                                             const gchar *title);
    void                webkit_web_history_item_set_alternate_title
                                                            (WebKitWebHistoryItem *web_history_item,
                                                             const gchar *title);

## Object Hierarchy

      GObject
       +----WebKitWebHistoryItem

## Properties

      "alternate-title"          gchar*                : Read / Write
      "last-visited-time"        gdouble               : Read
      "original-uri"             gchar*                : Read
      "title"                    gchar*                : Read
      "uri"                      gchar*                : Read

## Description

A history item consists out of a title and a uri. It can be part of the WebKitWebBackForwardList and the global history. The global history is used for coloring the links of visited sites. WebKitWebHistoryItem's constructed with webkit_web_history_item_new and webkit_web_history_item_new_with_data are automatically added to the global history.

    1
    2
    3
    /* Inject a visited page into the global history */
    webkit_web_history_item_new_with_data("http://www.gnome.org/", "GNOME: The Free Software Desktop Project");
    webkit_web_history_item_new_with_data("http://www.webkit.org/", "The WebKit Open Source Project");

## Details

### WebKitWebHistoryItem

    typedef struct _WebKitWebHistoryItem WebKitWebHistoryItem;

### webkit_web_history_item_copy ()

    WebKitWebHistoryItem * webkit_web_history_item_copy     (WebKitWebHistoryItem *web_history_item);

Makes a copy of the item for use with other WebView objects.

`web_history_item` : | a WebKitWebHistoryItem
Returns : | the new WebKitWebHistoryItem. [transfer full]

Since 1.1.18

### webkit_web_history_item_get_alternate_title ()

    const gchar *       webkit_web_history_item_get_alternate_title
                                                            (WebKitWebHistoryItem *web_history_item);

Returns the alternate title of `web_history_item`

`web_history_item` : | a WebKitWebHistoryItem
Returns : | the alternate title of `web_history_item`

### webkit_web_history_item_get_last_visited_time ()

    gdouble             webkit_web_history_item_get_last_visited_time
                                                            (WebKitWebHistoryItem *web_history_item);

### webkit_web_history_item_get_original_uri ()

    const gchar *       webkit_web_history_item_get_original_uri
                                                            (WebKitWebHistoryItem *web_history_item);

Returns the original URI of `web_history_item`.

`web_history_item` : | a WebKitWebHistoryItem
Returns : | the original URI of `web_history_item`

### webkit_web_history_item_get_title ()

    const gchar *       webkit_web_history_item_get_title   (WebKitWebHistoryItem *web_history_item);

`web_history_item` : | a WebKitWebHistoryItem
Returns : | the page title of `web_history_item`

### webkit_web_history_item_get_uri ()

    const gchar *       webkit_web_history_item_get_uri     (WebKitWebHistoryItem *web_history_item);

Returns the URI of `this`

`web_history_item` : | a WebKitWebHistoryItem
Returns : | the URI of `web_history_item`

### webkit_web_history_item_new ()

    WebKitWebHistoryItem * webkit_web_history_item_new      (void);

Creates a new WebKitWebHistoryItem instance

Returns : | the new WebKitWebHistoryItem

### webkit_web_history_item_new_with_data ()

    WebKitWebHistoryItem * webkit_web_history_item_new_with_data
                                                            (const gchar *uri,
                                                             const gchar *title);

Creates a new WebKitWebHistoryItem with the given URI and title

`uri` : | the URI of the page
`title` : | the title of the page
Returns : | the new WebKitWebHistoryItem

### webkit_web_history_item_set_alternate_title ()

    void                webkit_web_history_item_set_alternate_title
                                                            (WebKitWebHistoryItem *web_history_item,
                                                             const gchar *title);

Sets an alternate title for `web_history_item`

`web_history_item` : | a WebKitWebHistoryItem
`title` : | the alternate title for `this` history item

## Property Details

### The `"alternate-title"` property

      "alternate-title"          gchar*                : Read / Write

The alternate title of the history item.

Default value: NULL

Since 1.0.2

### The `"last-visited-time"` property

      "last-visited-time"        gdouble               : Read

The time at which the history item was last visited.

Allowed values: >= 0

Default value: 0

Since 1.0.2

### The `"original-uri"` property

      "original-uri"             gchar*                : Read

The original URI of the history item.

Default value: NULL

Since 1.0.2

### The `"title"` property

      "title"                    gchar*                : Read

The title of the history item.

Default value: NULL

Since 1.0.2

### The `"uri"` property

      "uri"                      gchar*                : Read

The URI of the history item.

Default value: NULL

Since 1.0.2

## See Also

WebKitWebBackForwardList