Gtk2::MenuItem(3pm)

Overview

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-allocate (Gtk2::MenuItem, integer)

toggle-size-request (Gtk2::MenuItem, gpointer)

Releases

7 releases since Debian 3.1 (Sarge); the text changed 6 times.

3.1
4.0
5.0
6.0
7
9
10