![]() |
![]() |
![]() |
WebKitGTK+ Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
WebKitWebBackForwardListWebKitWebBackForwardList — The history of a WebKitWebView |
WebKitWebBackForwardList; void webkit_web_back_forward_list_add_item (WebKitWebBackForwardList *web_back_forward_list
,WebKitWebHistoryItem *history_item
); gboolean webkit_web_back_forward_list_contains_item (WebKitWebBackForwardList *web_back_forward_list
,WebKitWebHistoryItem *history_item
); WebKitWebHistoryItem * webkit_web_back_forward_list_get_back_item (WebKitWebBackForwardList *web_back_forward_list
); gint webkit_web_back_forward_list_get_back_length (WebKitWebBackForwardList *web_back_forward_list
); GList * webkit_web_back_forward_list_get_back_list_with_limit (WebKitWebBackForwardList *web_back_forward_list
,gint limit
); WebKitWebHistoryItem * webkit_web_back_forward_list_get_current_item (WebKitWebBackForwardList *web_back_forward_list
); WebKitWebHistoryItem * webkit_web_back_forward_list_get_forward_item (WebKitWebBackForwardList *web_back_forward_list
); gint webkit_web_back_forward_list_get_forward_length (WebKitWebBackForwardList *web_back_forward_list
); GList * webkit_web_back_forward_list_get_forward_list_with_limit (WebKitWebBackForwardList *web_back_forward_list
,gint limit
); gint webkit_web_back_forward_list_get_limit (WebKitWebBackForwardList *web_back_forward_list
); WebKitWebHistoryItem * webkit_web_back_forward_list_get_nth_item (WebKitWebBackForwardList *web_back_forward_list
,gint index
); void webkit_web_back_forward_list_go_back (WebKitWebBackForwardList *web_back_forward_list
); void webkit_web_back_forward_list_go_forward (WebKitWebBackForwardList *web_back_forward_list
); void webkit_web_back_forward_list_go_to_item (WebKitWebBackForwardList *web_back_forward_list
,WebKitWebHistoryItem *history_item
); WebKitWebBackForwardList * webkit_web_back_forward_list_new_with_web_view (WebKitWebView *web_view
); void webkit_web_back_forward_list_set_limit (WebKitWebBackForwardList *web_back_forward_list
,gint limit
);
/* Get the WebKitWebBackForwardList from the WebKitWebView */ WebKitWebBackForwardList *back_forward_list = webkit_web_view_get_back_forward_list (my_web_view); WebKitWebHistoryItem *item = webkit_web_back_forward_list_get_current_item (back_forward_list); /* Do something with a WebKitWebHistoryItem */ g_print("%p", item); /* Control some parameters */ WebKitWebBackForwardList *back_forward_list = webkit_web_view_get_back_forward_list (my_web_view); webkit_web_back_forward_list_set_limit (back_forward_list, 30);
void webkit_web_back_forward_list_add_item (WebKitWebBackForwardList *web_back_forward_list
,WebKitWebHistoryItem *history_item
);
Adds the item to the WebKitWebBackForwardList.
The webBackForwardList
will add a reference to the webHistoryItem
, so you
don't need to keep a reference once you've added it to the list.
|
a WebKitWebBackForwardList |
|
the WebKitWebHistoryItem to add |
Since 1.1.1
gboolean webkit_web_back_forward_list_contains_item (WebKitWebBackForwardList *web_back_forward_list
,WebKitWebHistoryItem *history_item
);
Checks if web_history_item
is in the back forward list
Return: TRUE
if web_history_item
is in the back forward list, FALSE
if it doesn't
|
a WebKitWebBackForwardList |
|
the WebKitWebHistoryItem to check |
Returns : |
WebKitWebHistoryItem * webkit_web_back_forward_list_get_back_item
(WebKitWebBackForwardList *web_back_forward_list
);
Returns the item that precedes the current item
|
a WebKitWebBackForwardList |
Returns : |
the WebKitWebHistoryItem preceding the current item |
gint webkit_web_back_forward_list_get_back_length
(WebKitWebBackForwardList *web_back_forward_list
);
Returns the number of items that preced the current item.
|
a WebKitWebBackForwardList |
Returns : |
a gint corresponding to the number of items preceding the current item |
GList * webkit_web_back_forward_list_get_back_list_with_limit (WebKitWebBackForwardList *web_back_forward_list
,gint limit
);
Returns a list of items that precede the current item, limited by limit
|
a WebKitWebBackForwardList |
|
the number of items to retrieve |
Returns : |
a GList of items preceding the current item, limited by limit
|
WebKitWebHistoryItem * webkit_web_back_forward_list_get_current_item
(WebKitWebBackForwardList *web_back_forward_list
);
Returns the current item.
Returns a NULL value if the back forward list is empty
|
a WebKitWebBackForwardList |
Returns : |
a WebKitWebHistoryItem |
WebKitWebHistoryItem * webkit_web_back_forward_list_get_forward_item
(WebKitWebBackForwardList *web_back_forward_list
);
Returns the item that succeeds the current item.
Returns a NULL value if there nothing that succeeds the current item
|
a WebKitWebBackForwardList |
Returns : |
a WebKitWebHistoryItem |
gint webkit_web_back_forward_list_get_forward_length
(WebKitWebBackForwardList *web_back_forward_list
);
Returns the number of items that succeed the current item.
|
a WebKitWebBackForwardList |
Returns : |
a gint corresponding to the nuber of items succeeding the current item |
GList * webkit_web_back_forward_list_get_forward_list_with_limit (WebKitWebBackForwardList *web_back_forward_list
,gint limit
);
Returns a list of items that succeed the current item, limited by limit
|
a WebKitWebBackForwardList |
|
the number of items to retrieve |
Returns : |
a GList of items succeeding the current item, limited by limit
|
gint webkit_web_back_forward_list_get_limit
(WebKitWebBackForwardList *web_back_forward_list
);
Returns the maximum limit of the back forward list.
|
a WebKitWebBackForwardList |
Returns : |
a gint indicating the number of WebKitWebHistoryItem the back forward list can hold |
WebKitWebHistoryItem * webkit_web_back_forward_list_get_nth_item (WebKitWebBackForwardList *web_back_forward_list
,gint index
);
Returns the item at a given index relative to the current item.
|
a WebKitWebBackForwardList |
|
the index of the item |
Returns : |
the WebKitWebHistoryItem located at the specified index relative to the current item |
void webkit_web_back_forward_list_go_back
(WebKitWebBackForwardList *web_back_forward_list
);
Steps backward in the back forward list
|
a WebKitWebBackForwardList |
void webkit_web_back_forward_list_go_forward
(WebKitWebBackForwardList *web_back_forward_list
);
Steps forward in the back forward list
|
a WebKitWebBackForwardList |
void webkit_web_back_forward_list_go_to_item (WebKitWebBackForwardList *web_back_forward_list
,WebKitWebHistoryItem *history_item
);
Go to the specified web_history_item
in the back forward list
|
a WebKitWebBackForwardList |
|
the WebKitWebHistoryItem to go to |
WebKitWebBackForwardList * webkit_web_back_forward_list_new_with_web_view
(WebKitWebView *web_view
);
Creates an instance of the back forward list with a controlling WebKitWebView
|
the back forward list's WebKitWebView |
Returns : |
a WebKitWebBackForwardList |
void webkit_web_back_forward_list_set_limit (WebKitWebBackForwardList *web_back_forward_list
,gint limit
);
Sets the maximum limit of the back forward list. If the back forward list exceeds its capacity, items will be removed everytime a new item has been added.
|
a WebKitWebBackForwardList |
|
the limit to set the back forward list to |