struct GtkRadioAction

struct GtkRadioAction {
  GtkToggleAction parent;
};

gtk_radio_action_new ()

GtkRadioAction *    gtk_radio_action_new                (const gchar *name,
                                                         const gchar *label,
                                                         const gchar *tooltip,
                                                         const gchar *stock_id,
                                                         gint value);

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().

Since 2.4

gtk_radio_action_get_group ()

GSList *            gtk_radio_action_get_group          (GtkRadioAction *action);

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.

A common way to set up a group of radio group is the following:

1
2
3
4
5
6
7
8
9
10

GSList *group = NULL;
  GtkRadioAction *action;

  while (/* more actions to add */)
    {
       action = gtk_radio_action_new (...);

       gtk_radio_action_set_group (action, group);
       group = gtk_radio_action_get_group (action);
    }

Since 2.4

gtk_radio_action_set_group ()

void                gtk_radio_action_set_group          (GtkRadioAction *action,
                                                         GSList *group);

Sets the radio group for the radio action object.

Since 2.4

gtk_radio_action_join_group ()

void                gtk_radio_action_join_group         (GtkRadioAction *action,
                                                         GtkRadioAction *group_source);

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

Use this in language bindings instead of the gtk_radio_action_get_group() and gtk_radio_action_set_group() methods

A common way to set up a group of radio actions is the following:

1
2
3
4
5
6
7
8
9
10

GtkRadioAction *action;
  GtkRadioAction *last_action;

  while (/* more actions to add */)
    {
       action = gtk_radio_action_new (...);

       gtk_radio_action_join_group (action, last_action);
       last_action = action;
    }

Since 3.0

gtk_radio_action_get_current_value ()

gint                gtk_radio_action_get_current_value  (GtkRadioAction *action);

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

Since 2.4

gtk_radio_action_set_current_value ()

void                gtk_radio_action_set_current_value  (GtkRadioAction *action,
                                                         gint current_value);

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

Since 2.10