PHP Editor Review - Gtk Manual Gtk gtkmenushell

GtkMenuShell

Abstract base class for menu objects.

Object Hierarchy

GtkObject
`-- GtkWidget
`-- GtkContainer
`-- GtkMenuShell

Direct subclasses

GtkMenu, GtkMenuBar

Description

GtkMenuShell is a special kind of abstract container that provides its descendants GtkMenu and GtkMenuBar with methods and signals that are appropriate to typical menu behaviour.

There are three keybindings set up here which are carried down to the inheriting classes. These are as follows:
Escape cancels an existing popup menu
Return activates the current selection
Space also activates the current selected item
The activate-current signal has not been documented here because any attempt to harness it beyond these bindings results in abort. The same applies to the move-current signal, implemented here and given keybindings in both GtkMenu and GtkMenuBar.

Note that GtkMenuShell is an abstract base class, and can not be constructed directly.

Methods

append()
Adds item to end of menu.
prepend()
Adds item to start of menu.
insert()
Inserts item at specified position in menu.
deactivate()
Emits deactivate signal.
select_item()
Makes designated item emit the "select" signal.
deselect()
Makes designated item emit the "deselect" signal.
activate_item()
Makes designated item emit the "activate" signal.

Signals

"deactivate"
Emitted when the menu is no longer active.
"selection-done"
Emitted when selection is complete or cancelled.
"cancel"
Cancels menu using key bindings.