Top |
WebKitContextMenuWebKitContextMenu — Represents the context menu in a WebKitWebView |
WebKitContextMenu represents a context menu containing WebKitContextMenuItems in a WebKitWebView.
When a WebKitWebView is about to display the context menu, it
emits the “context-menu” signal, which has the
WebKitContextMenu as an argument. You can modify it, adding new
submenus that you can create with webkit_context_menu_new()
, adding
new WebKitContextMenuItems with
webkit_context_menu_prepend()
, webkit_context_menu_append()
or
webkit_context_menu_insert()
, maybe after having removed the
existing ones with webkit_context_menu_remove_all()
.
WebKitContextMenu *
webkit_context_menu_new (void
);
Creates a new WebKitContextMenu object to be used as a submenu of an existing
WebKitContextMenu. The context menu of a WebKitWebView is created by the view
and passed as an argument of “context-menu” signal.
To add items to the menu use webkit_context_menu_prepend()
,
webkit_context_menu_append()
or webkit_context_menu_insert()
.
See also webkit_context_menu_new_with_items()
to create a WebKitContextMenu with
a list of initial items.
WebKitContextMenu *
webkit_context_menu_new_with_items (GList *items
);
Creates a new WebKitContextMenu object to be used as a submenu of an existing
WebKitContextMenu with the given initial items.
See also webkit_context_menu_new()
void webkit_context_menu_prepend (WebKitContextMenu *menu
,WebKitContextMenuItem *item
);
Adds item
at the beginning of the menu
.
void webkit_context_menu_append (WebKitContextMenu *menu
,WebKitContextMenuItem *item
);
Adds item
at the end of the menu
.
void webkit_context_menu_insert (WebKitContextMenu *menu
,WebKitContextMenuItem *item
,gint position
);
Inserts item
into the menu
at the given position.
If position
is negative, or is larger than the number of items
in the WebKitContextMenu, the item is added on to the end of
the menu
. The first position is 0.
void webkit_context_menu_move_item (WebKitContextMenu *menu
,WebKitContextMenuItem *item
,gint position
);
Moves item
to the given position in the menu
.
If position
is negative, or is larger than the number of items
in the WebKitContextMenu, the item is added on to the end of
the menu
.
The first position is 0.
GList *
webkit_context_menu_get_items (WebKitContextMenu *menu
);
Returns the item list of menu
.
guint
webkit_context_menu_get_n_items (WebKitContextMenu *menu
);
Gets the length of the menu
.
WebKitContextMenuItem *
webkit_context_menu_first (WebKitContextMenu *menu
);
Gets the first item in the menu
.
the first WebKitContextMenuItem of menu
,
or NULL
if the WebKitContextMenu is empty.
[transfer none]
WebKitContextMenuItem *
webkit_context_menu_last (WebKitContextMenu *menu
);
Gets the last item in the menu
.
the last WebKitContextMenuItem of menu
,
or NULL
if the WebKitContextMenu is empty.
[transfer none]
WebKitContextMenuItem * webkit_context_menu_get_item_at_position (WebKitContextMenu *menu
,guint position
);
Gets the item at the given position in the menu
.
the WebKitContextMenuItem at position position
in menu
,
or NULL
if the position is off the end of the menu
.
[transfer none]
void webkit_context_menu_remove (WebKitContextMenu *menu
,WebKitContextMenuItem *item
);
Removes item
from the menu
.
See also webkit_context_menu_remove_all()
to remove all items.
void
webkit_context_menu_remove_all (WebKitContextMenu *menu
);
Removes all items of the menu
.
void webkit_context_menu_set_user_data (WebKitContextMenu *menu
,GVariant *user_data
);
Sets user data to menu
.
This function can be used from a Web Process extension to set user data
that can be retrieved from the UI Process using webkit_context_menu_get_user_data()
.
If the user_data
GVariant is floating, it is consumed.
Since: 2.8
GVariant *
webkit_context_menu_get_user_data (WebKitContextMenu *menu
);
Gets the user data of menu
.
This function can be used from the UI Process to get user data previously set
from the Web Process with webkit_context_menu_set_user_data()
.
Since: 2.8