WebKit.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 WebKit.ContextMenuItem(**kwargs)¶

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

One item of a WebKit.ContextMenu.

The WebKit.ContextMenu is composed of WebKit.ContextMenuItem s. These items can be created from a #GtkAction, from a WebKit.ContextMenuAction or from a WebKit.ContextMenuAction and a label. These WebKit.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 WebKit.ContextMenuItem object.

Return type:

WebKit.ContextMenuItem

Creates a new WebKit.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 (WebKit.ContextMenuAction) – a WebKit.ContextMenuAction stock action
Returns:: the newly created WebKit.ContextMenuItem object.
Return type:: WebKit.ContextMenuItem

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

Stock actions are handled automatically by WebKit so that, for example, when a menu item created with a WebKit.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 WebKit.ContextMenuItem created with a WebKit.ContextMenuAction with WebKit.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 (WebKit.ContextMenuAction) – a WebKit.ContextMenuAction stock action
label (str) – a custom label text to use instead of the predefined one

Returns:

the newly created WebKit.ContextMenuItem object.

Return type:

WebKit.ContextMenuItem

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

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

classmethod new_separator()¶

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

Creates a new WebKit.ContextMenuItem representing a separator.

classmethod new_with_submenu(label, submenu)¶

Parameters:

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

Returns:

the newly created WebKit.ContextMenuItem object.

Return type:

WebKit.ContextMenuItem

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

get_gaction()¶

Returns:: the Gio.Action associated to the WebKit.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 WebKit.ContextMenuAction of self
Return type:: WebKit.ContextMenuAction

Gets the WebKit.ContextMenuAction of self.

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

get_submenu()¶

Returns:: the WebKit.ContextMenu representing the submenu of self or None if self doesn’t have a submenu.
Return type:: WebKit.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 (WebKit.ContextMenu or None) – a WebKit.ContextMenu

Sets or replaces the self submenu.

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