Class

GtkRadioAction

Description [src]

class Gtk.RadioAction : Gtk.ToggleAction {
  parent: GtkToggleAction
}

A GtkRadioAction is similar to GtkRadioMenuItem. A number of radio actions can be linked together so that only one may be active at any one time.

Hierarchy

hierarchy this GtkRadioAction implements_0 GtkBuildable this--implements_0 ancestor_0 GtkToggleAction ancestor_0--this ancestor_1 GtkAction ancestor_1--ancestor_0 ancestor_2 GObject ancestor_2--ancestor_1

Implements

Constructors

gtk_radio_action_new

Creates a new GtkRadioAction object. To add the action to a GtkActionGroup and set the accelerator for the action, call gtk_action_group_add_action_with_accel().

Available since: 2.4

Instance methods

gtk_radio_action_get_current_value

Obtains the value property of the currently active member of the group to which action belongs.

Available since: 2.4

gtk_radio_action_get_group

Returns the list representing the radio group for this object. Note that the returned list is only valid until the next change to the group.

Available since: 2.4

gtk_radio_action_join_group

Joins a radio action object to the group of another radio action object.

Available since: 3.0

gtk_radio_action_set_current_value

Sets the currently active group member to the member with value property current_value.

Available since: 2.10

gtk_radio_action_set_group

Sets the radio group for the radio action object.

Available since: 2.4

Methods inherited from GtkToggleAction (5)
gtk_toggle_action_get_active

Returns the checked state of the toggle action.

Available since: 2.4

gtk_toggle_action_get_draw_as_radio

Returns whether the action should have proxies like a radio action.

Available since: 2.4

gtk_toggle_action_set_active

Sets the checked state on the toggle action.

Available since: 2.4

gtk_toggle_action_set_draw_as_radio

Sets whether the action should have proxies like a radio action.

Available since: 2.4

gtk_toggle_action_toggled

Emits the “toggled” signal on the toggle action.

Available since: 2.4

Methods inherited from GtkAction (41)
gtk_action_activate

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

Available since: 2.4

Deprecated since: 3.10

gtk_action_block_activate

Disable activation signals from the action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_connect_accelerator

Installs the accelerator for action if action has an accel path and group. See gtk_action_set_accel_path() and gtk_action_set_accel_group()

Available since: 2.4

Deprecated since: 3.10

gtk_action_create_icon

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

Available since: 2.4

Deprecated since: 3.10

gtk_action_create_menu

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

Available since: 2.12

Deprecated since: 3.10

gtk_action_create_menu_item

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

Available since: 2.4

Deprecated since: 3.10

gtk_action_create_tool_item

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

Available since: 2.4

Deprecated since: 3.10

gtk_action_disconnect_accelerator

Undoes the effect of one call to gtk_action_connect_accelerator().

Available since: 2.4

Deprecated since: 3.10

gtk_action_get_accel_closure

Returns the accel closure for this action.

Available since: 2.8

Deprecated since: 3.10

gtk_action_get_accel_path

Returns the accel path for this action.

Available since: 2.6

Deprecated since: 3.10

gtk_action_get_always_show_image

Returns whether actions menu item proxies will always show their image, if available.

Available since: 2.20

Deprecated since: 3.10

gtk_action_get_gicon

Gets the gicon of action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_icon_name

Gets the icon name of action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_is_important

Checks whether action is important or not.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_label

Gets the label text of action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_name

Returns the name of the action.

Available since: 2.4

Deprecated since: 3.10

gtk_action_get_proxies

Returns the proxy widgets for an action. See also gtk_activatable_get_related_action().

Available since: 2.4

gtk_action_get_sensitive

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

Available since: 2.4

Deprecated since: 3.10

gtk_action_get_short_label

Gets the short label text of action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_stock_id

Gets the stock id of action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_tooltip

Gets the tooltip text of action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_visible

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

Available since: 2.4

Deprecated since: 3.10

gtk_action_get_visible_horizontal

Checks whether action is visible when horizontal.

Available since: 2.16

Deprecated since: 3.10

Methods inherited from GObject (42)
Methods inherited from GtkBuildable (10)
gtk_buildable_add_child

Adds a child to buildable. type is an optional string describing how the child should be added.

Available since: 2.12

gtk_buildable_construct_child

Constructs a child of buildable with the name name.

Available since: 2.12

gtk_buildable_custom_finished

This is similar to gtk_buildable_parser_finished() but is called once for each custom tag handled by the buildable.

Available since: 2.12

gtk_buildable_custom_tag_end

This is called at the end of each custom element handled by the buildable.

Available since: 2.12

gtk_buildable_custom_tag_start

This is called for each unknown element under <child>.

Available since: 2.12

gtk_buildable_get_internal_child

Get the internal child called childname of the buildable object.

Available since: 2.12

gtk_buildable_get_name

Gets the name of the buildable object.

Available since: 2.12

gtk_buildable_parser_finished

Called when the builder finishes the parsing of a [GtkBuilder UI definition][BUILDER-UI]. Note that this will be called once for each time gtk_builder_add_from_file() or gtk_builder_add_from_string() is called on a builder.

Available since: 2.12

gtk_buildable_set_buildable_property

Sets the property name name to value on the buildable object.

Available since: 2.12

gtk_buildable_set_name

Sets the name of the buildable object.

Available since: 2.12

Properties

Gtk.RadioAction:current-value

The value property of the currently active member of the group to which this action belongs.

Available since: 2.10

Gtk.RadioAction:group

Sets a new group for a radio action.

Available since: 2.4

Gtk.RadioAction:value

The value is an arbitrary integer which can be used as a convenient way to determine which action in the group is currently active in an ::activate or ::changed signal handler. See gtk_radio_action_get_current_value() and GtkRadioActionEntry for convenient ways to get and set this property.

Available since: 2.4

Properties inherited from GtkToggleAction (2)
Gtk.ToggleAction:active

Whether the toggle action should be active.

Available since: 2.10

Gtk.ToggleAction:draw-as-radio

Whether the proxies for this action look like radio action proxies.

Properties inherited from GtkAction (16)
Gtk.Action:action-group

The GtkActionGroup this GtkAction is associated with, or NULL (for internal use).

Deprecated since: 3.10

Gtk.Action:always-show-image

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

Available since: 2.20

Deprecated since: 3.10

Gtk.Action:gicon

The GIcon displayed in the GtkAction.

Available since: 2.16

Deprecated since: 3.10

Gtk.Action:hide-if-empty

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

Deprecated since: 3.10

Gtk.Action:icon-name

The name of the icon from the icon theme.

Available since: 2.10

Deprecated since: 3.10

Gtk.Action:is-important

Whether the action is considered important. When TRUE, toolitem proxies for this action show text in GTK_TOOLBAR_BOTH_HORIZ mode.

Deprecated since: 3.10

Gtk.Action:label

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

Deprecated since: 3.10

Gtk.Action:name

A unique name for the action.

Deprecated since: 3.10

Gtk.Action:sensitive

Whether the action is enabled.

Deprecated since: 3.10

Gtk.Action:short-label

A shorter label that may be used on toolbar buttons.

Deprecated since: 3.10

Gtk.Action:stock-id

The stock icon displayed in widgets representing this action.

Deprecated since: 3.10

Gtk.Action:tooltip

A tooltip for this action.

Deprecated since: 3.10

Gtk.Action:visible

Whether the action is visible.

Deprecated since: 3.10

Gtk.Action:visible-horizontal

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

Deprecated since: 3.10

Gtk.Action:visible-overflown

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

Available since: 2.6

Deprecated since: 3.10

Gtk.Action:visible-vertical

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

Deprecated since: 3.10

Signals

Gtk.RadioAction::changed

The ::changed signal is emitted on every member of a radio group when the active member is changed. The signal gets emitted after the ::activate signals for the previous and current active members.

Available since: 2.4

Signals inherited from GtkToggleAction (1)
Gtk.ToggleAction::toggled

Should be connected if you wish to perform an action whenever the GtkToggleAction state is changed.

Signals inherited from GtkAction (1)
Gtk.Action::activate

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

Available since: 2.4

Deprecated since: 3.10

Signals inherited from GObject (1)

Class structure

struct GtkRadioActionClass {
  GtkToggleActionClass parent_class;
  void (* changed) (
    GtkRadioAction* action,
    GtkRadioAction* current
  );
  void (* _gtk_reserved1) (
void
  );
  void (* _gtk_reserved2) (
void
  );
  void (* _gtk_reserved3) (
void
  );
  void (* _gtk_reserved4) (
void
  );
  
}
Class members
parent_class
GtkToggleActionClass
  No description available.
changed
void (* changed) (
    GtkRadioAction* action,
    GtkRadioAction* current
  )
  No description available.
_gtk_reserved1
void (* _gtk_reserved1) (
void
  )
  No description available.
_gtk_reserved2
void (* _gtk_reserved2) (
void
  )
  No description available.
_gtk_reserved3
void (* _gtk_reserved3) (
void
  )
  No description available.
_gtk_reserved4
void (* _gtk_reserved4) (
void
  )
  No description available.

Virtual methods

Gtk.RadioActionClass.changed
No description available.