Gtk2::MenuItem

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

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.