NAME

       Gtk2::Action - wrapper for GtkAction

HIERARCHY

         Glib::Object
         +----Gtk2::Action

INTERFACES

         Gtk2::Buildable

CONSTRUCTOR

   action = Gtk2::Action->new (key=>value,...)
       Create and return a new action object.  Note that this is the "new" of Glib::Object, not
       "gtk_action_new".  Eg.

           Gtk2::Action->new (name => 'open-foo',
                              stock_id => 'gtk-open',
                              tooltip => 'Start a foo');

       The keyword/value style is more flexible and a little clearer than the four direct
       arguments of "gtk_action_new" (and also works better for subclasses).

METHODS

   $action->set_accel_group ($accel_group)
       •   $accel_group (Gtk2::AccelGroup or undef)

   string = $action->get_accel_path
       Since: gtk+ 2.6

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

   $action->activate
   boolean = $action->get_always_show_image
       Since: gtk+ 2.20

   $action->set_always_show_image ($always_show)
       •   $always_show (boolean)

       Since: gtk+ 2.20

   $action->block_activate
       Since: gtk+ 2.16

   $action->block_activate_from ($proxy)
       •   $proxy (Gtk2::Widget)

   $action->connect_accelerator
   $action->connect_proxy ($proxy)
       •   $proxy (Gtk2::Widget)

   widget = $action->create_icon ($icon_size)
       •   $icon_size (Gtk2::IconSize)

   widget = $action->create_menu
       Since: gtk+ 2.12

   widget = $action->create_menu_item
   widget = $action->create_tool_item
   $action->disconnect_accelerator
   $action->disconnect_proxy ($proxy)
       •   $proxy (Gtk2::Widget)

   string or undef = $action->get_icon_name
       Since: gtk+ 2.16

   $action->set_icon_name ($icon_name)
       •   $icon_name (string or undef)

       Since: gtk+ 2.16

   boolean = $action->get_is_important
       Since: gtk+ 2.16

   $action->set_is_important ($is_important)
       •   $is_important (boolean)

       Since: gtk+ 2.16

   boolean = $action->is_sensitive
   boolean = $action->is_visible
   string or undef = $action->get_label
       Since: gtk+ 2.16

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

       Since: gtk+ 2.16

   string = $action->get_name
   list = $action->get_proxies
   boolean = $action->get_sensitive
   $action->set_sensitive ($sensitive)
       •   $sensitive (boolean)

       Since: gtk+ 2.6

   string or undef = $action->get_short_label
       Since: gtk+ 2.16

   $action->set_short_label ($short_label)
       •   $short_label (string)

       Since: gtk+ 2.16

   string or undef = $action->get_stock_id
       Since: gtk+ 2.16

   $action->set_stock_id ($stock_id)
       •   $stock_id (string or undef)

       Since: gtk+ 2.16

   string or undef = $action->get_tooltip
       Since: gtk+ 2.16

   $action->set_tooltip ($tooltip)
       •   $tooltip (string or undef)

       Since: gtk+ 2.16

   $action->unblock_activate
       Since: gtk+ 2.16

   $action->unblock_activate_from ($proxy)
       •   $proxy (Gtk2::Widget)

   boolean = $action->get_visible
   boolean = $action->get_visible_horizontal
       Since: gtk+ 2.16

   $action->set_visible_horizontal ($visible_horizontal)
       •   $visible_horizontal (boolean)

       Since: gtk+ 2.16

   $action->set_visible ($visible)
       •   $visible (boolean)

       Since: gtk+ 2.6

   boolean = $action->get_visible_vertical
       Since: gtk+ 2.16

   $action->set_visible_vertical ($visible_vertical)
       •   $visible_vertical (boolean)

       Since: gtk+ 2.16

PROPERTIES

       'action-group' (Gtk2::ActionGroup : default undef : readable / writable / private)
           The GtkActionGroup this GtkAction is associated with, or NULL (for internal use).

       'always-show-image' (boolean : default false : readable / writable / construct / private)
           Whether the image will always be shown

       'gicon' (Glib::Object::_Unregistered::GIcon : default undef : readable / writable /
       private)
           The GIcon being displayed

       'hide-if-empty' (boolean : default true : readable / writable / private)
           When TRUE, empty menu proxies for this action are hidden.

       'icon-name' (string : default undef : readable / writable / private)
           The name of the icon from the icon theme

       'is-important' (boolean : default false : readable / writable / private)
           Whether the action is considered important. When TRUE, toolitem proxies for this
           action show text in GTK_TOOLBAR_BOTH_HORIZ mode.

       'label' (string : default undef : readable / writable / private)
           The label used for menu items and buttons that activate this action.

       'name' (string : default undef : readable / writable / construct-only / private)
           A unique name for the action.

       'sensitive' (boolean : default true : readable / writable / private)
           Whether the action is enabled.

       'short-label' (string : default undef : readable / writable / private)
           A shorter label that may be used on toolbar buttons.

       'stock-id' (string : default undef : readable / writable / private)
           The stock icon displayed in widgets representing this action.

       'tooltip' (string : default undef : readable / writable / private)
           A tooltip for this action.

       'visible' (boolean : default true : readable / writable / private)
           Whether the action is visible.

       'visible-horizontal' (boolean : default true : readable / writable / private)
           Whether the toolbar item is visible when the toolbar is in a horizontal orientation.

       'visible-overflown' (boolean : default true : readable / writable / private)
           When TRUE, toolitem proxies for this action are represented in the toolbar overflow
           menu.

       'visible-vertical' (boolean : default true : readable / writable / private)
           Whether the toolbar item is visible when the toolbar is in a vertical orientation.

SIGNALS

       activate (Gtk2::Action)

ENUMS AND FLAGS

   enum Gtk2::IconSize
       •   'invalid' / 'GTK_ICON_SIZE_INVALID'

       •   'menu' / 'GTK_ICON_SIZE_MENU'

       •   'small-toolbar' / 'GTK_ICON_SIZE_SMALL_TOOLBAR'

       •   'large-toolbar' / 'GTK_ICON_SIZE_LARGE_TOOLBAR'

       •   'button' / 'GTK_ICON_SIZE_BUTTON'

       •   'dnd' / 'GTK_ICON_SIZE_DND'

       •   'dialog' / 'GTK_ICON_SIZE_DIALOG'

SEE ALSO

       Gtk2, Glib::Object

COPYRIGHT

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

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