Gtk2::Action

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)

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

$action−>set_accel_path ($accel_path)

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

$action−>set_always_show_image ($always_show)

Since: gtk+ 2.20

$action−>block_activate
Since: gtk+ 2.16

$action−>block_activate_from ($proxy)

$action−>connect_accelerator
$action−>connect_proxy ($proxy)

widget = $action−>create_icon ($icon_size)

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)

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

$action−>set_icon_name ($icon_name)

Since: gtk+ 2.16

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

$action−>set_is_important ($is_important)

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)

Since: gtk+ 2.16

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

Since: gtk+ 2.6

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

$action−>set_short_label ($short_label)

Since: gtk+ 2.16

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

$action−>set_stock_id ($stock_id)

Since: gtk+ 2.16

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

$action−>set_tooltip ($tooltip)

Since: gtk+ 2.16

$action−>unblock_activate
Since: gtk+ 2.16

$action−>unblock_activate_from ($proxy)

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

$action−>set_visible_horizontal ($visible_horizontal)

Since: gtk+ 2.16

$action−>set_visible ($visible)

Since: gtk+ 2.6

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

$action−>set_visible_vertical ($visible_vertical)

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

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.