Signal
WebKit2WebView::context-menu
Declaration
gboolean
context_menu (
WebKitWebView* self,
WebKitContextMenu* context_menu,
GdkEvent* event,
WebKitHitTestResult* hit_test_result,
gpointer user_data
)
Description [src]
Emitted when a context menu is about to be displayed to give the application
a chance to customize the proposed menu, prevent the menu from being displayed,
or build its own context menu.
webkit_context_menu_append() or webkit_context_menu_insert() to add new
WebKitContextMenuItems to context_menu, webkit_context_menu_move_item()
to reorder existing items, or webkit_context_menu_remove() to remove an
existing item. The signal handler should return FALSE, and the menu represented
by context_menu will be shown.
TRUE so that the proposed menu will not be shown.
FALSE so
that the menu will be shown. You can also ignore the proposed WebKitContextMenu,
build your own GtkMenu and return TRUE to prevent the proposed menu from being shown.
The event is expected to be one of the following types:
GdkEventButton of type GDK_BUTTON_PRESS when the context menu
was triggered with mouse.
GdkEventKey of type GDK_KEY_PRESS if the keyboard was used to show
the menu.
GdkEvent of type GDK_NOTHING when the GtkWidget::popup-menu
signal was used to show the context menu.
If the signal handler returns FALSE the context menu represented by context_menu
will be shown, if it return TRUE the context menu will not be shown.
The proposed WebKitContextMenu passed in context_menu argument is only valid
during the signal emission.
| Default handler: The default handler is called after the handlers added via |
Parameters
context_menu-
Type:
WebKitContextMenuThe proposed
WebKitContextMenu.The data is owned by the caller of the function. event-
Type:
GdkEventThe
GdkEventthat triggered the context menu.The data is owned by the caller of the function. hit_test_result-
Type:
WebKitHitTestResultA
WebKitHitTestResult.The data is owned by the caller of the function.