WebKit2.ContextMenu

g GObject.Object GObject.Object WebKit2.ContextMenu WebKit2.ContextMenu GObject.Object->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:

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:

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:

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.