Nautilus.MenuItem¶

Subclasses:: None

Methods¶

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

class	`list_free` (item_list)
class	`new` (name, label, tip, icon)
	`activate` ()
	`set_submenu` (menu)

Virtual Methods¶

Inherited:: GObject.Object (7)

do_activate ()

Properties¶

Name	Type	Flags	Short Description
`icon`	`str`	r/w	Name of the icon to display in the menu item `deprecated`
`label`	`str`	r/w	Label to display to the user
`menu`	`Nautilus.Menu`	r/w	The menu belonging to this item. May be null.
`name`	`str`	r/w/co	Name of the item
`priority`	`bool`	r/w	Show priority text in toolbars `deprecated`
`sensitive`	`bool`	r/w	Whether the menu item is sensitive
`tip`	`str`	r/w	Tooltip for the menu item `deprecated`

Signals¶

Inherited:: GObject.Object (1)

Name	Short Description
`activate`	Signals that the user has activated this menu item.

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent_instance	`GObject.Object`	r

Class Details¶

class Nautilus.MenuItem(**kwargs)¶

Bases:: GObject.Object
Abstract:: No
Structure:: Nautilus.MenuItemClass

An individual item with a Nautilus context menu.

NautilusMenuItem is an object that describes an item in a file manager menu. Extensions can provide NautilusMenuItem objects by registering a [iface`NautilusMenuProvider`] and returning them from [method`NautilusMenuProvider`.get_file_items], or [method`NautilusMenuProvider`.get_background_items], which will be called by the main application when creating menus.

classmethod list_free(item_list)¶

Parameters:: item_list ([Nautilus.MenuItem]) – a list of Nautilus.MenuItem

Deep frees a list of NautilusMenuItem.

classmethod new(name, label, tip, icon)¶

Parameters:

name (str) – the identifier for the menu item
label (str) – the user-visible label of the menu item
tip (str or None) – this has no effect
icon (str or None) – this has no effect

Returns:

a new Nautilus.MenuItem

Return type:

Nautilus.MenuItem

Creates a new menu item that can be added to the toolbar or to a contextual menu.

activate()¶: Emits Nautilus.MenuItem ::activate.

set_submenu(menu)¶

Parameters:: menu (Nautilus.Menu) – pointer to a Nautilus.Menu to attach to the button

Attaches a menu to the given Nautilus.MenuItem.

do_activate() virtual¶: Emits Nautilus.MenuItem ::activate.

Signal Details¶

Nautilus.MenuItem.signals.activate(menu_item)¶

Signal Name:: activate
Flags:: RUN_LAST
Parameters:: menu_item (Nautilus.MenuItem) – The object which received the signal

Signals that the user has activated this menu item.

Property Details¶

Nautilus.MenuItem.props.icon¶

Name:: icon
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

This property has no effect.

Deprecated since version 4.1.

Nautilus.MenuItem.props.label¶

Name:: label
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

A user visible string describing the NautilusMenuItem.

Nautilus.MenuItem.props.menu¶

Name:: menu
Type:: Nautilus.Menu
Default Value:: None
Flags:: READABLE, WRITABLE

A submenu for the current NautilusMenuItem.

Nautilus.MenuItem.props.name¶

Name:: name
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE, CONSTRUCT_ONLY

A unique identifier for the NautilusMenuItem. This is not user visible.

Nautilus.MenuItem.props.priority¶

Name:: priority
Type:: bool
Default Value:: True
Flags:: READABLE, WRITABLE

This property has no effect.

Deprecated since version 4.1.

Nautilus.MenuItem.props.sensitive¶

Name:: sensitive
Type:: bool
Default Value:: True
Flags:: READABLE, WRITABLE

Whether the NautilusMenuItem should be sensitive (i.e. clickable).

Nautilus.MenuItem.props.tip¶

Name:: tip
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

This property has no effect.

Deprecated since version 4.1.