Gtk.Action¶

Subclasses:	`Gtk.RecentAction`, `Gtk.ToggleAction`

Methods¶

Inherited:	GObject.Object (37), Gtk.Buildable (10)
Structs:	GObject.ObjectClass (5)

class	`new` (name, label, tooltip, stock_id)
	`activate` ()
	`block_activate` ()
	`connect_accelerator` ()
	`create_icon` (icon_size)
	`create_menu` ()
	`create_menu_item` ()
	`create_tool_item` ()
	`disconnect_accelerator` ()
	`get_accel_closure` ()
	`get_accel_path` ()
	`get_always_show_image` ()
	`get_gicon` ()
	`get_icon_name` ()
	`get_is_important` ()
	`get_label` ()
	`get_name` ()
	`get_proxies` ()
	`get_sensitive` ()
	`get_short_label` ()
	`get_stock_id` ()
	`get_tooltip` ()
	`get_visible` ()
	`get_visible_horizontal` ()
	`get_visible_vertical` ()
	`is_sensitive` ()
	`is_visible` ()
	`set_accel_group` (accel_group)
	`set_accel_path` (accel_path)
	`set_always_show_image` (always_show)
	`set_gicon` (icon)
	`set_icon_name` (icon_name)
	`set_is_important` (is_important)
	`set_label` (label)
	`set_sensitive` (sensitive)
	`set_short_label` (short_label)
	`set_stock_id` (stock_id)
	`set_tooltip` (tooltip)
	`set_visible` (visible)
	`set_visible_horizontal` (visible_horizontal)
	`set_visible_vertical` (visible_vertical)
	`unblock_activate` ()

Virtual Methods¶

Inherited:	GObject.Object (7), Gtk.Buildable (10)

	`do_activate` ()
	`do_connect_proxy` (proxy)
	`do_create_menu` ()
	`do_create_menu_item` ()
	`do_create_tool_item` ()
	`do_disconnect_proxy` (proxy)

Properties¶

Name	Type	Flags	Short Description
`action-group`	`Gtk.ActionGroup`	r/w	The `Gtk.ActionGroup` this `Gtk.Action` is associated with, or `None` (for internal use). `deprecated`
`always-show-image`	`bool`	r/w/c	Whether the image will always be shown `deprecated`
`gicon`	`Gio.Icon`	r/w	The `Gio.Icon` being displayed `deprecated`
`hide-if-empty`	`bool`	r/w	When `True`, empty menu proxies for this action are hidden. `deprecated`
`icon-name`	`str`	r/w	The name of the icon from the icon theme `deprecated`
`is-important`	`bool`	r/w	Whether the action is considered important. When `True`, toolitem proxies for this action show text in `Gtk.ToolbarStyle.BOTH_HORIZ` mode. `deprecated`
`label`	`str`	r/w	The label used for menu items and buttons that activate this action. `deprecated`
`name`	`str`	r/w/co	A unique name for the action. `deprecated`
`sensitive`	`bool`	r/w	Whether the action is enabled. `deprecated`
`short-label`	`str`	r/w	A shorter label that may be used on toolbar buttons. `deprecated`
`stock-id`	`str`	r/w	The stock icon displayed in widgets representing this action. `deprecated`
`tooltip`	`str`	r/w	A tooltip for this action. `deprecated`
`visible`	`bool`	r/w	Whether the action is visible. `deprecated`
`visible-horizontal`	`bool`	r/w	Whether the toolbar item is visible when the toolbar is in a horizontal orientation. `deprecated`
`visible-overflown`	`bool`	r/w	When `True`, toolitem proxies for this action are represented in the toolbar overflow menu. `deprecated`
`visible-vertical`	`bool`	r/w	Whether the toolbar item is visible when the toolbar is in a vertical orientation. `deprecated`

Signals¶

Inherited:	GObject.Object (1)

Name	Short Description
`activate`	The “activate” signal is emitted when the action is activated. `deprecated`

Fields¶

Inherited:	GObject.Object (1)

Name	Type	Access	Description
object	`GObject.Object`	r

Class Details¶

class Gtk.Action(*args, **kwargs)¶

Bases:	`GObject.Object`, `Gtk.Buildable`
Abstract:	No
Structure:	`Gtk.ActionClass`

In GTK+ 3.10, Gtk.Action has been deprecated. Use Gio.Action instead, and associate actions with Gtk.Actionable widgets. Use Gio.MenuModel for creating menus with Gtk.Menu.new_from_model().

Actions represent operations that the user can be perform, along with some information how it should be presented in the interface. Each action provides methods to create icons, menu items and toolbar items representing itself.

As well as the callback that is called when the action gets activated, the following also gets associated with the action:

a name (not translated, for path lookup)
a label (translated, for display)
an accelerator
whether label indicates a stock id
a tooltip (optional, translated)
a toolbar label (optional, shorter than label)

The action will also have some state information:

visible (shown/hidden)
sensitive (enabled/disabled)

Apart from regular actions, there are toggle actions, which can be toggled between two states and radio actions, of which only one in a group can be in the “active” state. Other actions can be implemented as Gtk.Action subclasses.

Each action can have one or more proxy widgets. To act as an action proxy, widget needs to implement Gtk.Activatable interface. Proxies mirror the state of the action and should change when the action’s state changes. Properties that are always mirrored by proxies are Gtk.Action :sensitive and Gtk.Action :visible. Gtk.Action :gicon, Gtk.Action :icon-name, Gtk.Action :label, Gtk.Action :short-label and Gtk.Action :stock-id properties are only mirorred if proxy widget has Gtk.Activatable :use-action-appearance property set to True.

When the proxy is activated, it should activate its action.

classmethod new(name, label, tooltip, stock_id)[source]¶

Parameters:	name (`str`) – A unique name for the action label (`str` or `None`) – the label displayed in menu items and on buttons, or `None` tooltip (`str` or `None`) – a tooltip for the action, or `None` stock_id (`str` or `None`) – the stock icon to display in widgets representing the action, or `None`
Returns:	a new `Gtk.Action`
Return type:	`Gtk.Action`

Creates a new Gtk.Action object. To add the action to a Gtk.ActionGroup and set the accelerator for the action, call Gtk.ActionGroup.add_action_with_accel(). See the UI Definition section for information on allowed action names.

New in version 2.4.

Deprecated since version 3.10: Use Gio.Action instead, associating it to a widget with Gtk.Actionable or creating a Gtk.Menu with Gtk.Menu.new_from_model()

activate()[source]¶

Emits the “activate” signal on the specified action, if it isn’t insensitive. This gets called by the proxy widgets when they get activated.

It can also be used to manually activate an action.

New in version 2.4.

Deprecated since version 3.10: Use Gio.ActionGroup.activate_action() on a Gio.Action instead

block_activate()[source]¶

Disable activation signals from the action

This is needed when updating the state of your proxy Gtk.Activatable widget could result in calling Gtk.Action.activate(), this is a convenience function to avoid recursing in those cases (updating toggle state for instance).

New in version 2.16.

Deprecated since version 3.10: Use Gio.SimpleAction.set_enabled() to disable the Gio.SimpleAction instead

connect_accelerator()[source]¶

Installs the accelerator for self if self has an accel path and group. See Gtk.Action.set_accel_path() and Gtk.Action.set_accel_group()

Since multiple proxies may independently trigger the installation of the accelerator, the self counts the number of times this function has been called and doesn’t remove the accelerator until Gtk.Action.disconnect_accelerator() has been called as many times.

New in version 2.4.

Deprecated since version 3.10: Use Gio.Action and the accelerator group on an associated Gtk.Menu instead

create_icon(icon_size)[source]¶

Parameters:	icon_size (`int`) – the size of the icon (`Gtk.IconSize`) that should be created.
Returns:	a widget that displays the icon for this action.
Return type:	`Gtk.Widget`

This function is intended for use by action implementations to create icons displayed in the proxy widgets.

New in version 2.4.

Deprecated since version 3.10: Use Gio.MenuItem.set_icon() to set an icon on a Gio.MenuItem, or Gtk.Container.add() to add a Gtk.Image to a Gtk.Button

create_menu()[source]¶

Returns:	the menu item provided by the action, or `None`.
Return type:	`Gtk.Widget`

If self provides a Gtk.Menu widget as a submenu for the menu item or the toolbar item it creates, this function returns an instance of that menu.

New in version 2.12.

Deprecated since version 3.10: Use Gio.Action and Gio.MenuModel instead, and create a Gtk.Menu with Gtk.Menu.new_from_model()

create_menu_item()[source]¶

Returns:	a menu item connected to the action.
Return type:	`Gtk.Widget`

Creates a menu item widget that proxies for the given action.

New in version 2.4.

Deprecated since version 3.10: Use Gio.MenuItem.new() and associate it with a Gio.Action instead.

create_tool_item()[source]¶

Returns:	a toolbar item connected to the action.
Return type:	`Gtk.Widget`

Creates a toolbar item widget that proxies for the given action.

New in version 2.4.

Deprecated since version 3.10: Use a Gtk.ToolItem and associate it with a Gio.Action using Gtk.Actionable.set_action_name() instead

disconnect_accelerator()[source]¶: Undoes the effect of one call to Gtk.Action.connect_accelerator().

New in version 2.4.

Deprecated since version 3.10: Use Gio.Action and the accelerator group on an associated Gtk.Menu instead

get_accel_closure()[source]¶

Returns:	the accel closure for this action. The returned closure is owned by GTK+ and must not be unreffed or modified.
Return type:	`GObject.Closure`

Returns the accel closure for this action.

New in version 2.8.

Deprecated since version 3.10: Use Gio.Action and Gtk.Menu instead, which have no equivalent for getting the accel closure

get_accel_path()[source]¶

Returns:	the accel path for this action, or `None` if none is set. The returned string is owned by GTK+ and must not be freed or modified.
Return type:	`str`

Returns the accel path for this action.

New in version 2.6.

Deprecated since version 3.10: Use Gio.Action and the accelerator path on an associated Gtk.Menu instead

get_always_show_image()[source]¶

Returns:	`True` if the menu item proxies will always show their image
Return type:	`bool`

Returns whether self’s menu item proxies will always show their image, if available.

New in version 2.20.

Deprecated since version 3.10: Use Gio.MenuItem.get_attribute_value() on a Gio.MenuItem instead

get_gicon()[source]¶

Returns:	The action’s `Gio.Icon` if one is set.
Return type:	`Gio.Icon`

Gets the gicon of self.

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and Gio.MenuItem.get_attribute_value() to get an icon from a Gio.MenuItem associated with a Gio.Action

get_icon_name()[source]¶

Returns:	the icon name
Return type:	`str`

Gets the icon name of self.

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and Gio.MenuItem.get_attribute_value() to get an icon from a Gio.MenuItem associated with a Gio.Action

get_is_important()[source]¶

Returns:	whether self is important
Return type:	`bool`

Checks whether self is important or not

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and control and monitor whether labels are shown directly

get_label()[source]¶

Returns:	the label text
Return type:	`str`

Gets the label text of self.

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and get a label from a menu item with Gio.MenuItem.get_attribute_value(). For Gtk.Actionable widgets, use the widget-specific API to get a label

get_name()[source]¶

Returns:	the name of the action. The string belongs to GTK+ and should not be freed.
Return type:	`str`

Returns the name of the action.

New in version 2.4.

Deprecated since version 3.10: Use Gio.Action.get_name() on a Gio.Action instead

get_proxies()[source]¶

Returns:	a `GLib.SList` of proxy widgets. The list is owned by GTK+ and must not be modified.
Return type:	[`Gtk.Widget`]

Returns the proxy widgets for an action. See also Gtk.Activatable.get_related_action().

New in version 2.4.

Deprecated since version 3.10.

get_sensitive()[source]¶

Returns:	`True` if the action itself is sensitive.
Return type:	`bool`

Returns whether the action itself is sensitive. Note that this doesn’t necessarily mean effective sensitivity. See Gtk.Action.is_sensitive() for that.

New in version 2.4.

Deprecated since version 3.10: Use Gio.Action.get_enabled() on a Gio.Action instead

get_short_label()[source]¶

Returns:	the short label text.
Return type:	`str`

Gets the short label text of self.

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, which has no equivalent of short labels

get_stock_id()[source]¶

Returns:	the stock id
Return type:	`str`

Gets the stock id of self.

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, which has no equivalent of stock items

get_tooltip()[source]¶

Returns:	the tooltip text
Return type:	`str`

Gets the tooltip text of self.

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and get tooltips from associated Gtk.Actionable widgets with Gtk.Widget.get_tooltip_text()

get_visible()[source]¶

Returns:	`True` if the action itself is visible.
Return type:	`bool`

Returns whether the action itself is visible. Note that this doesn’t necessarily mean effective visibility. See Gtk.Action.is_sensitive() for that.

New in version 2.4.

Deprecated since version 3.10: Use Gio.Action instead, and control and monitor the state of Gtk.Actionable widgets directly

get_visible_horizontal()[source]¶

Returns:	whether self is visible when horizontal
Return type:	`bool`

Checks whether self is visible when horizontal

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and control and monitor the visibility of associated widgets and menu items directly

get_visible_vertical()[source]¶

Returns:	whether self is visible when horizontal
Return type:	`bool`

Checks whether self is visible when horizontal

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and control and monitor the visibility of associated widgets and menu items directly

is_sensitive()[source]¶

Returns:	`True` if the action and its associated action group are both sensitive.
Return type:	`bool`

Returns whether the action is effectively sensitive.

New in version 2.4.

Deprecated since version 3.10: Use Gio.Action.get_enabled() on a Gio.Action instead

is_visible()[source]¶

Returns:	`True` if the action and its associated action group are both visible.
Return type:	`bool`

Returns whether the action is effectively visible.

New in version 2.4.

Deprecated since version 3.10: Use Gio.Action instead, and control and monitor the state of Gtk.Actionable widgets directly

set_accel_group(accel_group)[source]¶

Parameters:	accel_group (`Gtk.AccelGroup` or `None`) – a `Gtk.AccelGroup` or `None`

Sets the Gtk.AccelGroup in which the accelerator for this action will be installed.

New in version 2.4.

Deprecated since version 3.10: Use Gio.Action and the accelerator group on an associated Gtk.Menu instead

set_accel_path(accel_path)[source]¶

Parameters:	accel_path (`str`) – the accelerator path

Sets the accel path for this action. All proxy widgets associated with the action will have this accel path, so that their accelerators are consistent.

Note that accel_path string will be stored in a #GQuark. Therefore, if you pass a static string, you can save some memory by interning it first with GLib.intern_static_string().

New in version 2.4.

Deprecated since version 3.10: Use Gio.Action and the accelerator path on an associated Gtk.Menu instead

set_always_show_image(always_show)[source]¶

Parameters:	always_show (`bool`) – `True` if menuitem proxies should always show their image

Sets whether self’s menu item proxies will ignore the Gtk.Settings :gtk-menu-images setting and always show their image, if available.

Use this if the menu item would be useless or hard to use without their image.

New in version 2.20.

Deprecated since version 3.10: Use Gio.MenuItem.set_icon() on a Gio.MenuItem instead, if the item should have an image

set_gicon(icon)[source]¶

Parameters:	icon (`Gio.Icon`) – the `Gio.Icon` to set

Sets the icon of self.

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and Gio.MenuItem.set_icon() to set an icon on a Gio.MenuItem associated with a Gio.Action, or Gtk.Container.add() to add a Gtk.Image to a Gtk.Button

set_icon_name(icon_name)[source]¶

Parameters:	icon_name (`str`) – the icon name to set

Sets the icon name on self

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and Gio.MenuItem.set_icon() to set an icon on a Gio.MenuItem associated with a Gio.Action, or Gtk.Container.add() to add a Gtk.Image to a Gtk.Button

set_is_important(is_important)[source]¶

Parameters:	is_important (`bool`) – `True` to make the action important

Sets whether the action is important, this attribute is used primarily by toolbar items to decide whether to show a label or not.

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and control and monitor whether labels are shown directly

set_label(label)[source]¶

Parameters:	label (`str`) – the label text to set

Sets the label of self.

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and set a label on a menu item with Gio.MenuItem.set_label(). For Gtk.Actionable widgets, use the widget-specific API to set a label

set_sensitive(sensitive)[source]¶

Parameters:	sensitive (`bool`) – `True` to make the action sensitive

Sets the :sensitive property of the action to sensitive. Note that this doesn’t necessarily mean effective sensitivity. See Gtk.Action.is_sensitive() for that.

New in version 2.6.

Deprecated since version 3.10: Use Gio.SimpleAction.set_enabled() on a Gio.SimpleAction instead

set_short_label(short_label)[source]¶

Parameters:	short_label (`str`) – the label text to set

Sets a shorter label text on self.

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, which has no equivalent of short labels

set_stock_id(stock_id)[source]¶

Parameters:	stock_id (`str`) – the stock id

Sets the stock id on self

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, which has no equivalent of stock items

set_tooltip(tooltip)[source]¶

Parameters:	tooltip (`str`) – the tooltip text

Sets the tooltip text on self

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and set tooltips on associated Gtk.Actionable widgets with Gtk.Widget.set_tooltip_text()

set_visible(visible)[source]¶

Parameters:	visible (`bool`) – `True` to make the action visible

Sets the :visible property of the action to visible. Note that this doesn’t necessarily mean effective visibility. See Gtk.Action.is_visible() for that.

New in version 2.6.

Deprecated since version 3.10: Use Gio.Action instead, and control and monitor the state of Gtk.Actionable widgets directly

set_visible_horizontal(visible_horizontal)[source]¶

Parameters:	visible_horizontal (`bool`) – whether the action is visible horizontally

Sets whether self is visible when horizontal

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and control and monitor the visibility of associated widgets and menu items directly

set_visible_vertical(visible_vertical)[source]¶

Parameters:	visible_vertical (`bool`) – whether the action is visible vertically

Sets whether self is visible when vertical

New in version 2.16.

Deprecated since version 3.10: Use Gio.Action instead, and control and monitor the visibility of associated widgets and menu items directly

unblock_activate()[source]¶: Reenable activation signals from the action

New in version 2.16.

Deprecated since version 3.10: Use Gio.SimpleAction.set_enabled() to enable the Gio.SimpleAction instead

do_activate() virtual¶

Emits the “activate” signal on the specified action, if it isn’t insensitive. This gets called by the proxy widgets when they get activated.

It can also be used to manually activate an action.

New in version 2.4.

Deprecated since version 3.10: Use Gio.ActionGroup.activate_action() on a Gio.Action instead

do_connect_proxy(proxy) virtual¶

Parameters:	proxy (`Gtk.Widget`) –

do_create_menu() virtual¶

Returns:	the menu item provided by the action, or `None`.
Return type:	`Gtk.Widget`

If action provides a Gtk.Menu widget as a submenu for the menu item or the toolbar item it creates, this function returns an instance of that menu.

New in version 2.12.

Deprecated since version 3.10: Use Gio.Action and Gio.MenuModel instead, and create a Gtk.Menu with Gtk.Menu.new_from_model()

do_create_menu_item() virtual¶

Returns:	a menu item connected to the action.
Return type:	`Gtk.Widget`

Creates a menu item widget that proxies for the given action.

New in version 2.4.

Deprecated since version 3.10: Use Gio.MenuItem.new() and associate it with a Gio.Action instead.

do_create_tool_item() virtual¶

Returns:	a toolbar item connected to the action.
Return type:	`Gtk.Widget`

Creates a toolbar item widget that proxies for the given action.

New in version 2.4.

Deprecated since version 3.10: Use a Gtk.ToolItem and associate it with a Gio.Action using Gtk.Actionable.set_action_name() instead

do_disconnect_proxy(proxy) virtual¶

Parameters:	proxy (`Gtk.Widget`) –

Signal Details¶

Gtk.Action.signals.activate(action)¶

Signal Name:	`activate`
Flags:	`RUN_FIRST`, `NO_RECURSE`
Parameters:	action (`Gtk.Action`) – The object which received the signal

The “activate” signal is emitted when the action is activated.

New in version 2.4.

Deprecated since version 3.10: Use Gio.SimpleAction ::activate instead

Property Details¶

Gtk.Action.props.action_group¶

Name:	`action-group`
Type:	`Gtk.ActionGroup`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

The Gtk.ActionGroup this Gtk.Action is associated with, or None (for internal use).

Deprecated since version 3.10: Lookup the Gio.Action using Gio.ActionMap.lookup_action() instead

Gtk.Action.props.always_show_image¶

Name:	`always-show-image`
Type:	`bool`
Default Value:	`False`
Flags:	`READABLE`, `WRITABLE`, `CONSTRUCT`

If True, the action’s menu item proxies will ignore the Gtk.Settings :gtk-menu-images setting and always show their image, if available.

Use this property if the menu item would be useless or hard to use without their image.

New in version 2.20.

Deprecated since version 3.10: There is no corresponding replacement when using Gio.Action

Gtk.Action.props.gicon¶

Name:	`gicon`
Type:	`Gio.Icon`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

The Gio.Icon displayed in the Gtk.Action.

Note that the stock icon is preferred, if the Gtk.Action :stock-id property holds the id of an existing stock icon.

This is an appearance property and thus only applies if Gtk.Activatable :use-action-appearance is True.

New in version 2.16.

Deprecated since version 3.10: Use the “icon” attribute on a Gio.MenuItem instead

Gtk.Action.props.hide_if_empty¶

Name:	`hide-if-empty`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

When True, empty menu proxies for this action are hidden.

Deprecated since version 3.10: There is no corresponding replacement when using Gio.Action

Gtk.Action.props.icon_name¶

Name:	`icon-name`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

The name of the icon from the icon theme.

Note that the stock icon is preferred, if the Gtk.Action :stock-id property holds the id of an existing stock icon, and the Gio.Icon is preferred if the Gtk.Action :gicon property is set.

This is an appearance property and thus only applies if Gtk.Activatable :use-action-appearance is True.

New in version 2.10.

Deprecated since version 3.10: Use the “icon” attribute on a Gio.MenuItem instead

Gtk.Action.props.is_important¶

Name:	`is-important`
Type:	`bool`
Default Value:	`False`
Flags:	`READABLE`, `WRITABLE`

Whether the action is considered important. When True, toolitem proxies for this action show text in Gtk.ToolbarStyle.BOTH_HORIZ mode.

Deprecated since version 3.10: There is no corresponding replacement when using Gio.Action

Gtk.Action.props.label¶

Name:	`label`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

The label used for menu items and buttons that activate this action. If the label is None, GTK+ uses the stock label specified via the stock-id property.

This is an appearance property and thus only applies if Gtk.Activatable :use-action-appearance is True.

Deprecated since version 3.10: Use the “label” attribute on Gio.MenuItem instead

Gtk.Action.props.name¶

Name:	`name`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`, `CONSTRUCT_ONLY`

A unique name for the action.

Deprecated since version 3.10: Use Gio.Action :name instead

Gtk.Action.props.sensitive¶

Name:	`sensitive`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether the action is enabled.

Deprecated since version 3.10: Use Gio.Action :enabled and Gio.SimpleAction :enabled instead

Gtk.Action.props.short_label¶

Name:	`short-label`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

A shorter label that may be used on toolbar buttons.

This is an appearance property and thus only applies if Gtk.Activatable :use-action-appearance is True.

Deprecated since version 3.10: There is no corresponding replacement when using Gio.Action

Gtk.Action.props.stock_id¶

Name:	`stock-id`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

The stock icon displayed in widgets representing this action.

This is an appearance property and thus only applies if Gtk.Activatable :use-action-appearance is True.

Deprecated since version 3.10: There is no corresponding replacement when using Gio.Action

Gtk.Action.props.tooltip¶

Name:	`tooltip`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

A tooltip for this action.

Deprecated since version 3.10: Use Gtk.Widget.set_tooltip_text() instead

Gtk.Action.props.visible¶

Name:	`visible`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether the action is visible.

Deprecated since version 3.10: There is no corresponding replacement when using Gio.Action

Gtk.Action.props.visible_horizontal¶

Name:	`visible-horizontal`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether the toolbar item is visible when the toolbar is in a horizontal orientation.

Deprecated since version 3.10: There is no corresponding replacement when using Gio.Action

Gtk.Action.props.visible_overflown¶

Name:	`visible-overflown`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

When True, toolitem proxies for this action are represented in the toolbar overflow menu.

New in version 2.6.

Deprecated since version 3.10: There is no corresponding replacement when using Gio.Action

Gtk.Action.props.visible_vertical¶

Name:	`visible-vertical`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether the toolbar item is visible when the toolbar is in a vertical orientation.

Deprecated since version 3.10: There is no corresponding replacement when using Gio.Action