WebKitWebProcessExtension.ContextMenuItem¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37)
Structs:: GObject.ObjectClass (5)

class	`new_from_gaction` (action, label, target)
class	`new_from_stock_action` (action)
class	`new_from_stock_action_with_label` (action, label)
class	`new_separator` ()
class	`new_with_submenu` (label, submenu)
	`get_gaction` ()
	`get_stock_action` ()
	`get_submenu` ()
	`is_separator` ()
	`set_submenu` (submenu)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

None

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Class Details¶

class WebKitWebProcessExtension.ContextMenuItem(**kwargs)¶

Bases:: GObject.InitiallyUnowned
Abstract:: No
Structure:: WebKitWebProcessExtension.ContextMenuItemClass

One item of a WebKitWebProcessExtension.ContextMenu.

The WebKitWebProcessExtension.ContextMenu is composed of WebKitWebProcessExtension.ContextMenuItem s. These items can be created from a #GtkAction, from a WebKitWebProcessExtension.ContextMenuAction or from a WebKitWebProcessExtension.ContextMenuAction and a label. These WebKitWebProcessExtension.ContextMenuAction s denote stock actions for the items. You can also create separators and submenus.

classmethod new_from_gaction(action, label, target)¶

Parameters:

action (Gio.Action) – a Gio.Action
label (str) – the menu item label text
target (GLib.Variant or None) – a GLib.Variant to use as the action target

Returns:

the newly created WebKitWebProcessExtension.ContextMenuItem object.

Return type:

WebKitWebProcessExtension.ContextMenuItem

Creates a new WebKitWebProcessExtension.ContextMenuItem for the given action and label.

On activation target will be passed as parameter to the callback.

New in version 2.18.

classmethod new_from_stock_action(action)¶

Parameters:: action (WebKitWebProcessExtension.ContextMenuAction) – a WebKitWebProcessExtension.ContextMenuAction stock action
Returns:: the newly created WebKitWebProcessExtension.ContextMenuItem object.
Return type:: WebKitWebProcessExtension.ContextMenuItem

Creates a new WebKitWebProcessExtension.ContextMenuItem for the given stock action.

Stock actions are handled automatically by WebKit so that, for example, when a menu item created with a WebKitWebProcessExtension.ContextMenuAction.STOP is activated the action associated will be handled by WebKit and the current load operation will be stopped. You can get the Gio.Action of a WebKitWebProcessExtension.ContextMenuItem created with a WebKitWebProcessExtension.ContextMenuAction with WebKitWebProcessExtension.ContextMenuItem.get_gaction() and connect to the Gio.SimpleAction ::activate signal to be notified when the item is activated, but you can’t prevent the associated action from being performed.

classmethod new_from_stock_action_with_label(action, label)¶

Parameters:

action (WebKitWebProcessExtension.ContextMenuAction) – a WebKitWebProcessExtension.ContextMenuAction stock action
label (str) – a custom label text to use instead of the predefined one

Returns:

the newly created WebKitWebProcessExtension.ContextMenuItem object.

Return type:

WebKitWebProcessExtension.ContextMenuItem

Creates a new WebKitWebProcessExtension.ContextMenuItem for the given stock action using the given label.

Stock actions have a predefined label, this method can be used to create a WebKitWebProcessExtension.ContextMenuItem for a WebKitWebProcessExtension.ContextMenuAction but using a custom label.

classmethod new_separator()¶

Returns:: the newly created WebKitWebProcessExtension.ContextMenuItem object.
Return type:: WebKitWebProcessExtension.ContextMenuItem

Creates a new WebKitWebProcessExtension.ContextMenuItem representing a separator.

classmethod new_with_submenu(label, submenu)¶

Parameters:

label (str) – the menu item label text
submenu (WebKitWebProcessExtension.ContextMenu) – a WebKitWebProcessExtension.ContextMenu to set

Returns:

the newly created WebKitWebProcessExtension.ContextMenuItem object.

Return type:

WebKitWebProcessExtension.ContextMenuItem

Creates a new WebKitWebProcessExtension.ContextMenuItem using the given label with a submenu.

get_gaction()¶

Returns:: the Gio.Action associated to the WebKitWebProcessExtension.ContextMenuItem, or None if self is a separator.
Return type:: Gio.Action

Gets the action associated to self as a Gio.Action.

New in version 2.18.

get_stock_action()¶

Returns:: the WebKitWebProcessExtension.ContextMenuAction of self
Return type:: WebKitWebProcessExtension.ContextMenuAction

Gets the WebKitWebProcessExtension.ContextMenuAction of self.

If the WebKitWebProcessExtension.ContextMenuItem was not created for a stock action WebKitWebProcessExtension.ContextMenuAction.CUSTOM will be returned. If the WebKitWebProcessExtension.ContextMenuItem is a separator WebKitWebProcessExtension.ContextMenuAction.NO_ACTION will be returned.

get_submenu()¶

Returns:: the WebKitWebProcessExtension.ContextMenu representing the submenu of self or None if self doesn’t have a submenu.
Return type:: WebKitWebProcessExtension.ContextMenu

Gets the submenu of self.

is_separator()¶

Returns:: True is self is a separator or False otherwise
Return type:: bool

Checks whether self is a separator.

set_submenu(submenu)¶

Parameters:: submenu (WebKitWebProcessExtension.ContextMenu or None) – a WebKitWebProcessExtension.ContextMenu

Sets or replaces the self submenu.

If submenu is None the current submenu of self is removed.