Provided by: libgtk2-perl-doc_1.249-2_all bug

NAME

       Gtk2::MenuItem - wrapper for GtkMenuItem

DESCRIPTION

       If a MenuItem is created with a $label string, or if the "label" property is set later,
       then it should be destroyed with "$item->destroy".  Just dropping the last Perl ref is not
       enough because (as of Gtk through to 2.18) there's a circular reference from the child
       "Gtk2::AccelLabel" back up to the item (the "accel-widget" property).

       When a MenuItem is in a "Gtk2::Menu" a "destroy" happens automatically.  Dropping the last
       ref to a Menu calls "destroy" on its children, as usual for a container.  But if you
       remove a MenuItem with a label from a menu (or never add it to one) then be sure to
       "$item->destroy" explicitly.

HIERARCHY

         Glib::Object
         +----Glib::InitiallyUnowned
              +----Gtk2::Object
                   +----Gtk2::Widget
                        +----Gtk2::Container
                             +----Gtk2::Bin
                                  +----Gtk2::Item
                                       +----Gtk2::MenuItem

INTERFACES

         Glib::Object::_Unregistered::AtkImplementorIface
         Gtk2::Buildable
         Gtk2::Activatable

METHODS

   widget = Gtk2::MenuItem->new ($label=undef)
       •   $label (string)

       If a $label argument is given then this is "new_with_mnemonic".

   widget = Gtk2::MenuItem->new_with_label ($label=undef)
       •   $label (string)

   widget = Gtk2::MenuItem->new_with_mnemonic ($label=undef)
       •   $label (string)

   string = $menu_item->get_accel_path
       Since: gtk+ 2.14

   $menu_item->set_accel_path ($accel_path)
       •   $accel_path (string)

   $menu_item->activate
   $menu_item->deselect
   string = $menu_item->get_label
       Since: gtk+ 2.16

   $menu_item->set_label ($label)
       •   $label (string)

       Since: gtk+ 2.16

   $menu_item->remove_submenu
   boolean = $menu_item->get_right_justified
   $menu_item->set_right_justified ($right_justified)
       •   $right_justified (boolean)

   $menu_item->select
   widget or undef = $menu_item->get_submenu
   $menu_item->set_submenu ($submenu)
       •   $submenu (Gtk2::Widget or undef)

   $menu_item->toggle_size_allocate ($allocation)
       •   $allocation (integer)

   requisition = $menu_item->toggle_size_request
   boolean = $menu_item->get_use_underline
       Since: gtk+ 2.16

   $menu_item->set_use_underline ($use_underline)
       •   $use_underline (boolean)

       Since: gtk+ 2.16

PROPERTIES

       'accel-path' (string : default undef : readable / writable / private)
           Sets the accelerator path of the menu item

       'label' (string : default "" : readable / writable / private)
           The text for the child label

       'right-justified' (boolean : default false : readable / writable / private)
           Sets whether the menu item appears justified at the right side of a menu bar

       'submenu' (Gtk2::Menu : default undef : readable / writable / private)
           The submenu attached to the menu item, or NULL if it has none

       'use-underline' (boolean : default false : readable / writable / private)
           If set, an underline in the text indicates the next character should be used for the
           mnemonic accelerator key

STYLE PROPERTIES

       'arrow-scaling' (float : default 0.8 : readable / private)
           Amount of space used up by arrow, relative to the menu item's font size

       'arrow-spacing' (integer : default 10 : readable / private)
           Space between label and arrow

       'horizontal-padding' (integer : default 3 : readable / private)
           Padding to left and right of the menu item

       'selected-shadow-type' (Gtk2::ShadowType : default "none" : readable / private)
           Shadow type when item is selected

       'toggle-spacing' (integer : default 5 : readable / private)
           Space between icon and label

       'width-chars' (integer : default 12 : readable / private)
           The minimum desired width of the menu item in characters

SIGNALS

       activate (Gtk2::MenuItem)
       activate-item (Gtk2::MenuItem)
       toggle-size-request (Gtk2::MenuItem, gpointer)
       toggle-size-allocate (Gtk2::MenuItem, integer)

SEE ALSO

       Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container,
       Gtk2::Bin, Gtk2::Item

COPYRIGHT

       Copyright (C) 2003-2011 by the gtk2-perl team.

       This software is licensed under the LGPL.  See Gtk2 for a full notice.