_
ShellThis widget is a base class for all menu widgets. It contains a list of items that can be navigated, selected and activated by the user. It can not be instantiated directly.
A menu is considered "active" when it is displayed on the screen, or, in the case of a menu_bar when one of its menus is active.
An item is "selected" if it is displayed in a prelight state and its submenu (if any) displayed.
Widget Hierarchy |
---|
GObject (see Package_Glib.Object) Gtk_Object (see Package_Gtk.Object) \___ Gtk_Widget (see Package_Gtk.Widget) \___ Gtk_Container (see Package_Gtk.Container) \___ Gtk_Menu_Shell (see Package_Gtk.Menu_Shell) |
Signals |
---|
procedure Handler (Menu_Shell : access Gtk_Menu_Shell_Record'Class;
Force_Hide : Gboolean);
Activates the current menu item within the Menu_Shell. if Force_Hide is True, hide the menu afterwards.
procedure Handler (Menu_Shell : access Gtk_Menu_Shell_Record'Class);
Cancels the selection within the menu_shell. Causes a "selection-done" signal to be emitted.
procedure Handler (Menu_Shell : access Gtk_Menu_Shell_Record'Class);
Emitted when the menu is deactivated, ie is erased from the screen.
procedure Handler (Menu_Shell : access Gtk_Menu_Shell_Record'Class;
Direction : Gtk_Menu_Direction_Type);
An action signal which selects another menu item (given by direction). In a menu, this is bound by default to the arrow keys to move the the selection.
procedure Handler (Menu_Shell : access Gtk_Menu_Shell_Record'Class);
Emitted when an item has been selected. The menu shell might not be activated when the signal is emitted.
Subprograms |
---|
function Get_Type return Gtk.Gtk_Type; | ||
Return the internal value associated with a Gtk_Menu_Shell. | ||
procedure Append (Menu_Shell : access Gtk_Menu_Shell_Record; Child : access Gtk_Menu_Item_Record'Class); | ||
Add a new item at the end of the menu. | ||
procedure Prepend (Menu_Shell : access Gtk_Menu_Shell_Record; Child : access Gtk_Menu_Item_Record'Class); | ||
Add a new item at the beginning of the menu | ||
procedure Insert (Menu_Shell : access Gtk_Menu_Shell_Record; Child : access Gtk_Menu_Item_Record'Class; Position : Gint); | ||
Add a new item at a specific position in the menu. The first item is at position 0. To insert as the last item in the menu, set Position to -1. | ||
Signals emission | ||
procedure Deactivate (Menu_Shell : access Gtk_Menu_Shell_Record); | ||
Emit the "deactivate" signal. This deselects the selected item, ungrabs the mouse and keyboard, and erase the Menu_Shell from the screen. | ||
procedure Select_Item (Menu_Shell : access Gtk_Menu_Shell_Record; Item : access Gtk_Menu_Item_Record'Class); | ||
Select a new item in the menu, after deselecting the current item. | ||
procedure Deselect (Menu_Shell : access Gtk_Menu_Shell_Record); | ||
Deselect the currently selected item. | ||
procedure Activate_Item (Menu_Shell : access Gtk_Menu_Shell_Record; Item : access Gtk_Menu_Item_Record'Class; Force_Deactivate : Boolean); | ||
Activate the item. If Force_Deactivate is True or the menu_shell sets this property, Menu_Shell and all its parent menus are deactivated and erased from the screen. |