| GTK+ Reference Manual |
|---|
GtkRadioActionGtkRadioAction — An action of which only one in a group can be active |
#include <gtk/gtk.h>
GtkRadioAction;
GtkRadioAction* gtk_radio_action_new (const gchar *name,
const gchar *label,
const gchar *tooltip,
const gchar *stock_id,
gint value);
GSList* gtk_radio_action_get_group (GtkRadioAction *action);
void gtk_radio_action_set_group (GtkRadioAction *action,
GSList *group);
gint gtk_radio_action_get_current_value
(GtkRadioAction *action);
"changed" void user_function (GtkRadioAction *action, GtkRadioAction *current, gpointer user_data);
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.
typedef struct _GtkRadioAction GtkRadioAction;
The GtkRadioAction struct contains only private members and should not be accessed directly.
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().
name : |
A unique name for the action |
label : |
The label displayed in menu items and on buttons |
tooltip : |
A tooltip for this action |
stock_id : |
The stock icon to display in widgets representing this action |
value : |
The value which gtk_radio_action_get_current_value() should return
if this action is selected.
|
| Returns : | a new GtkRadioAction |
Since 2.4
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:
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);
}
action : |
the action object |
| Returns : | the list representing the radio group for this object |
Since 2.4
void gtk_radio_action_set_group (GtkRadioAction *action, GSList *group);
Sets the radio group for the radio action object.
action : |
the action object |
group : |
a list representing a radio group |
Since 2.4
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.
action : |
a GtkRadioAction |
| Returns : | The value of the currently active group member |
Since 2.4
value" property"value" gint : Read / Write
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.
Default value: 0
Since 2.4
void user_function (GtkRadioAction *action, GtkRadioAction *current, gpointer user_data);
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.
action : |
the action on which the signal is emitted |
current : |
the member of actions group which has just been activated
|
user_data : |
user data set when the signal handler was connected. |
Since 2.4
| << GtkToggleAction | Selectors (File/Font/Color/Input Devices) >> |