WebKit2.ContextMenu¶

Subclasses:: None

Methods¶

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

class	`new` ()
class	`new_with_items` (items)
	`append` (item)
	`first` ()
	`get_event` ()
	`get_item_at_position` (position)
	`get_items` ()
	`get_n_items` ()
	`get_user_data` ()
	`insert` (item, position)
	`last` ()
	`move_item` (item, position)
	`prepend` (item)
	`remove` (item)
	`remove_all` ()
	`set_user_data` (user_data)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

None

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent	`GObject.Object`	r

Class Details¶

class WebKit2.ContextMenu(**kwargs)¶

Bases:: GObject.Object
Abstract:: No
Structure:: WebKit2.ContextMenuClass

Represents the context menu in a WebKit2.WebView.

WebKit2.ContextMenu represents a context menu containing WebKit2.ContextMenuItem s in a WebKit2.WebView.

When a WebKit2.WebView is about to display the context menu, it emits the WebKit2.WebView ::context-menu signal, which has the WebKit2.ContextMenu as an argument. You can modify it, adding new submenus that you can create with WebKit2.ContextMenu.new(), adding new WebKit2.ContextMenuItem s with WebKit2.ContextMenu.prepend(), WebKit2.ContextMenu.append() or WebKit2.ContextMenu.insert(), maybe after having removed the existing ones with WebKit2.ContextMenu.remove_all().

classmethod new()¶

Returns:: The newly created WebKit2.ContextMenu object
Return type:: WebKit2.ContextMenu

Creates a new WebKit2.ContextMenu object.

Creates a new WebKit2.ContextMenu object to be used as a submenu of an existing WebKit2.ContextMenu. The context menu of a WebKit2.WebView is created by the view and passed as an argument of WebKit2.WebView ::context-menu signal. To add items to the menu use WebKit2.ContextMenu.prepend(), WebKit2.ContextMenu.append() or WebKit2.ContextMenu.insert(). See also WebKit2.ContextMenu.new_with_items() to create a WebKit2.ContextMenu with a list of initial items.

classmethod new_with_items(items)¶

Parameters:: items ([WebKit2.ContextMenuItem]) – a GLib.List of WebKit2.ContextMenuItem
Returns:: The newly created WebKit2.ContextMenu object
Return type:: WebKit2.ContextMenu

Creates a new WebKit2.ContextMenu object with the given items.

Creates a new WebKit2.ContextMenu object to be used as a submenu of an existing WebKit2.ContextMenu with the given initial items. See also WebKit2.ContextMenu.new()

append(item)¶

Parameters:: item (WebKit2.ContextMenuItem) – the WebKit2.ContextMenuItem to add

Adds item at the end of the self.

first()¶

Returns:: the first WebKit2.ContextMenuItem of self, or None if the WebKit2.ContextMenu is empty.
Return type:: WebKit2.ContextMenuItem

Gets the first item in the self.

get_event()¶

Returns:: the menu event or None.
Return type:: Gdk.Event

Gets the Gdk.Event that triggered the context menu. This function only returns a valid Gdk.Event when called for a WebKit2.ContextMenu passed to WebKit2.WebView ::context-menu signal; in all other cases, None is returned.

The returned Gdk.Event is expected to be one of the following types:

a Gdk.EventButton of type Gdk.EventType.BUTTON_PRESS when the context menu was triggered with mouse.
a Gdk.EventKey of type Gdk.EventType.KEY_PRESS if the keyboard was used to show the menu.
a generic Gdk.Event of type Gdk.EventType.NOTHING when the Gtk.Widget ::popup-menu signal was used to show the context menu.

New in version 2.40.

get_item_at_position(position)¶

Parameters:: position (int) – the position of the item, counting from 0
Returns:: the WebKit2.ContextMenuItem at position position in self, or None if the position is off the end of the self.
Return type:: WebKit2.ContextMenuItem

Gets the item at the given position in the self.

get_items()¶

Returns:: a GLib.List of WebKit2.ContextMenuItem s
Return type:: [WebKit2.ContextMenuItem]

Returns the item list of self.

get_n_items()¶

Returns:: the number of WebKit2.ContextMenuItem s in self
Return type:: int

Gets the length of the self.

get_user_data()¶

Returns:: the user data of self, or None if self doesn’t have user data
Return type:: GLib.Variant

Gets the user data of self.

This function can be used from the UI Process to get user data previously set from the Web Process with WebKit2.ContextMenu.set_user_data().

New in version 2.8.

insert(item, position)¶

Parameters:

item (WebKit2.ContextMenuItem) – the WebKit2.ContextMenuItem to add
position (int) – the position to insert the item

Inserts item into the self at the given position.

If position is negative, or is larger than the number of items in the WebKit2.ContextMenu, the item is added on to the end of the self. The first position is 0.

last()¶

Returns:: the last WebKit2.ContextMenuItem of self, or None if the WebKit2.ContextMenu is empty.
Return type:: WebKit2.ContextMenuItem

Gets the last item in the self.

move_item(item, position)¶

Parameters:

item (WebKit2.ContextMenuItem) – the WebKit2.ContextMenuItem to add
position (int) – the new position to move the item

Moves item to the given position in the self.

If position is negative, or is larger than the number of items in the WebKit2.ContextMenu, the item is added on to the end of the self. The first position is 0.

prepend(item)¶

Parameters:: item (WebKit2.ContextMenuItem) – the WebKit2.ContextMenuItem to add

Adds item at the beginning of the self.

remove(item)¶

Parameters:: item (WebKit2.ContextMenuItem) – the WebKit2.ContextMenuItem to remove

Removes item from the self.

See also WebKit2.ContextMenu.remove_all() to remove all items.

remove_all()¶: Removes all items of the self.

set_user_data(user_data)¶

Parameters:: user_data (GLib.Variant) – a GLib.Variant

Sets user data to self.

This function can be used from a Web Process extension to set user data that can be retrieved from the UI Process using WebKit2.ContextMenu.get_user_data(). If the user_data GLib.Variant is floating, it is consumed.

New in version 2.8.