<!-- ##### SECTION Title ##### -->GtkMenuShell<!-- ##### SECTION Short_Description ##### -->A base class for menu objects<!-- ##### SECTION Long_Description ##### --><para>A #GtkMenuShell is the abstract base class used to derive the #GtkMenu and #GtkMenuBar subclasses.  </para><para>A #GtkMenuShell is a container of #GtkMenuItem objects arranged in a list which can be navigated, selected, and activated by the user to performapplication functions.  A #GtkMenuItem can have a submenu associated with it,allowing for nested hierarchical menus.</para><!-- ##### SECTION See_Also ##### --><para></para><!-- ##### SECTION Stability_Level ##### --><!-- ##### STRUCT GtkMenuShell ##### --><para>The #GtkMenuShell-struct struct contains the following fields.(These fields should be considered read-only. They should never be set byan application.)<informaltable pgwide="1" frame="none" role="struct"><tgroup cols="2"><colspec colwidth="2*"/><colspec colwidth="8*"/><tbody><row><entry>#GList *children;</entry><entry>The list of #GtkMenuItem objects contained by this #GtkMenuShell.</entry></row></tbody></tgroup></informaltable></para><!-- ##### SIGNAL GtkMenuShell::activate-current ##### --><para>An action signal that activates the current menu item within the menushell.</para>@menushell: the object which received the signal.@force_hide: if TRUE, hide the menu after activating the menu item.<!-- ##### SIGNAL GtkMenuShell::cancel ##### --><para>An action signal which cancels the selection within the menu shell.Causes the GtkMenuShell::selection-done signal to be emitted.</para>@menushell: the object which received the signal.<!-- ##### SIGNAL GtkMenuShell::cycle-focus ##### --><para></para>@menushell: the object which received the signal.@arg1: <!-- ##### SIGNAL GtkMenuShell::deactivate ##### --><para>This signal is emitted when a menu shell is deactivated.</para>@menushell: the object which received the signal.<!-- ##### SIGNAL GtkMenuShell::move-current ##### --><para>An action signal which moves the current menu item in the direction specified by @direction.</para>@menushell: the object which received the signal.@direction: the direction to move.<!-- ##### SIGNAL GtkMenuShell::selection-done ##### --><para>This signal is emitted when a selection has been completed within a menushell.</para>@menushell: the object which received the signal.<!-- ##### FUNCTION gtk_menu_shell_append ##### --><para>Adds a new #GtkMenuItem to the end of the menu shell's item list.</para>@menu_shell: a #GtkMenuShell.@child: The #GtkMenuItem to add.<!-- ##### FUNCTION gtk_menu_shell_prepend ##### --><para>Adds a new #GtkMenuItem to the beginning of the menu shell's item list.</para>@menu_shell: a #GtkMenuShell.@child: The #GtkMenuItem to add.<!-- ##### FUNCTION gtk_menu_shell_insert ##### --><para>Adds a new #GtkMenuItem to the menu shell's item list at the positionindicated by @position. </para>@menu_shell: a #GtkMenuShell.@child: The #GtkMenuItem to add.@position: The position in the item list where @child is added.Positions are numbered from 0 to n-1.<!-- ##### FUNCTION gtk_menu_shell_deactivate ##### --><para>Deactivates the menu shell.  Typically this results in the menu shellbeing erased from the screen.</para>@menu_shell: a #GtkMenuShell.<!-- ##### FUNCTION gtk_menu_shell_select_item ##### --><para>Selects the menu item from the menu shell.</para>@menu_shell: a #GtkMenuShell.@menu_item: The #GtkMenuItem to select.<!-- ##### FUNCTION gtk_menu_shell_select_first ##### --><para></para>@menu_shell: @search_sensitive: <!-- ##### FUNCTION gtk_menu_shell_deselect ##### --><para>Deselects the currently selected item from the menu shell, if any.</para>@menu_shell: a #GtkMenuShell.<!-- ##### FUNCTION gtk_menu_shell_activate_item ##### --><para>Activates the menu item within the menu shell.</para>@menu_shell: a #GtkMenuShell.@menu_item: The #GtkMenuItem to activate.@force_deactivate: If TRUE, force the deactivation of the menu shellafter the menu item is activated.<!-- ##### FUNCTION gtk_menu_shell_cancel ##### --><para></para>@menu_shell: <!-- ##### ENUM GtkMenuDirectionType ##### --><para>An enumeration representing directional movements within a menu.<informaltable pgwide="1" frame="none" role="enum"><tgroup cols="2"><colspec colwidth="2*"/><colspec colwidth="8*"/><tbody><row><entry>GTK_MENU_DIR_PARENT</entry><entry>To the parent menu shell.</entry></row><row><entry>GTK_MENU_DIR_CHILD</entry><entry>To the submenu, if any, associated with the item.</entry></row><row><entry>GTK_MENU_DIR_NEXT</entry><entry>To the next menu item.</entry></row><row><entry>GTK_MENU_DIR_PREV</entry><entry>To the previous menu item.</entry></row></tbody></tgroup></informaltable></para>@GTK_MENU_DIR_PARENT: @GTK_MENU_DIR_CHILD: @GTK_MENU_DIR_NEXT: @GTK_MENU_DIR_PREV: