GtkRadioAction
GtkRadioAction — An action of which only one in a group can be active
|
|
Implemented Interfaces
GtkRadioAction implements
GtkBuildable.
Includes
#include <gtk/gtk.h>
Description
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.
Functions
gtk_radio_action_get_group ()
GSList *
gtk_radio_action_get_group (GtkRadioAction *action);
gtk_radio_action_get_group has been deprecated since version 3.10 and should not be used in newly-written code.
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:
Returns
the list representing the radio group for this object.
[element-type GtkRadioAction][transfer none]
Since: 2.4
gtk_radio_action_set_group ()
void
gtk_radio_action_set_group (GtkRadioAction *action,
GSList *group);
gtk_radio_action_set_group has been deprecated since version 3.10 and should not be used in newly-written code.
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);
gtk_radio_action_join_group has been deprecated since version 3.10 and should not be used in newly-written code.
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:
Since: 3.0
gtk_radio_action_get_current_value ()
gint
gtk_radio_action_get_current_value (GtkRadioAction *action);
gtk_radio_action_get_current_value has been deprecated since version 3.10 and should not be used in newly-written code.
Obtains the value property of the currently active member of
the group to which action
belongs.
Returns
The value of the currently active group member
Since: 2.4
gtk_radio_action_set_current_value ()
void
gtk_radio_action_set_current_value (GtkRadioAction *action,
gint current_value);
gtk_radio_action_set_current_value has been deprecated since version 3.10 and should not be used in newly-written code.
Sets the currently active group member to the member with value
property current_value
.
Since: 2.10
Types and Values
struct GtkRadioAction
struct GtkRadioAction;
Property Details
The “current-value” property
“current-value” gint
The value property of the currently active member of the group to which
this action belongs.
GtkRadioAction:current-value has been deprecated since version 3.10 and should not be used in newly-written code.
Owner: GtkRadioAction
Flags: Read / Write
Default value: 0
Since: 2.10
The “group” property
“group” GtkRadioAction *
Sets a new group for a radio action.
GtkRadioAction:group has been deprecated since version 3.10 and should not be used in newly-written code.
Owner: GtkRadioAction
Flags: Write
Since: 2.4
The “value” property
“value” gint
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.
GtkRadioAction:value has been deprecated since version 3.10 and should not be used in newly-written code.
Owner: GtkRadioAction
Flags: Read / Write
Default value: 0
Since: 2.4
Signal Details
The “changed” signal
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.
GtkRadioAction::changed has been deprecated since version 3.10 and should not be used in newly-written code.
Flags: No Recursion
Since: 2.4