Oxyscripts - PHP Development, tutorials, articles, news, programming, scripts and forums.

GtkMenu

Popup container for menu items.

Object Hierarchy

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

Direct subclasses

None.

Description

GtkMenu is a menushell widget, designed to exclusively hold GtkMenuItems. It may be a standalone popup widget, or may be associated either with a higher-level GtkMenuItem within a GtkMenuBar, or with a GtkOptionMenu.

Note that a GtkMenu in any form is effectively a modal popup widget. There are keybindings in place here specifically to counteract this apparent isolation, by allowing the Up, Down, Left and Right arrow keys to navigate multiple menus with regard to the relationships between those menus (i.e. parent and child, next and previous). These are fairly rudimentary in the current version of GTK+ used in PHP-GTK, but have been improved recently.

See also: GtkCombo, GtkCTree, GtkItemFactory, GtkList, GtkRadioButton, GtkToolbar.

Constructor

GtkMenu (void);
-- Creates the structure to hold a menu's content.

Methods

popup()
Pops up a menu.
reposition()
Repositions menu.
popdown()
Pops down menu.
get_active()
Gets currently selected GtkMenuItem.
set_active()
Sets active menu item.
set_accel_group()
Sets the GtkAccelGroup holding global accelerators.
get_accel_group()
Gets the GtkAccelGroup holding global accelerators.
get_uline_accel_group()
Gets the internally-used GtkAccelGroup, if there is one.
ensure_uline_accel_group()
Creates a GtkAccelGroup for internal menu use if one does not exist.
attach_to_widget()
Sets attachment to specified widget.
detach()
Detaches menu from associated widget.
get_attach_widget()
Returns the widget currently attached.
set_tearoff_state()
Toggles whether menu is torn off.
set_title()
Sets the title for a torn off menu.
reorder_child()
Moves specified item to given position.