|  |  |  | GTK+ 3 Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
#include <gtk/gtk.h> struct GtkToggleAction; GtkToggleAction * gtk_toggle_action_new (const gchar *name,const gchar *label,const gchar *tooltip,const gchar *stock_id); void gtk_toggle_action_toggled (GtkToggleAction *action); void gtk_toggle_action_set_active (GtkToggleAction *action,gboolean is_active); gboolean gtk_toggle_action_get_active (GtkToggleAction *action); void gtk_toggle_action_set_draw_as_radio (GtkToggleAction *action,gboolean draw_as_radio); gboolean gtk_toggle_action_get_draw_as_radio (GtkToggleAction *action);
A GtkToggleAction corresponds roughly to a GtkCheckMenuItem. It has an "active" state specifying whether the action has been checked or not.
GtkToggleAction * gtk_toggle_action_new (const gchar *name,const gchar *label,const gchar *tooltip,const gchar *stock_id);
Creates a new GtkToggleAction object. To add the action to
a GtkActionGroup and set the accelerator for the action,
call gtk_action_group_add_action_with_accel().
| 
 | A unique name for the action | 
| 
 | The label displayed in menu items and on buttons,
or NULL. [allow-none] | 
| 
 | A tooltip for the action, or NULL. [allow-none] | 
| 
 | The stock icon to display in widgets representing
the action, or NULL. [allow-none] | 
| Returns : | a new GtkToggleAction | 
Since 2.4
void                gtk_toggle_action_toggled           (GtkToggleAction *action);
Emits the "toggled" signal on the toggle action.
| 
 | the action object | 
Since 2.4
void gtk_toggle_action_set_active (GtkToggleAction *action,gboolean is_active);
Sets the checked state on the toggle action.
| 
 | the action object | 
| 
 | whether the action should be checked or not | 
Since 2.4
gboolean            gtk_toggle_action_get_active        (GtkToggleAction *action);
Returns the checked state of the toggle action.
| 
 | the action object | 
| Returns : | the checked state of the toggle action | 
Since 2.4
void gtk_toggle_action_set_draw_as_radio (GtkToggleAction *action,gboolean draw_as_radio);
Sets whether the action should have proxies like a radio action.
| 
 | the action object | 
| 
 | whether the action should have proxies like a radio action | 
Since 2.4
gboolean            gtk_toggle_action_get_draw_as_radio (GtkToggleAction *action);
Returns whether the action should have proxies like a radio action.
| 
 | the action object | 
| Returns : | whether the action should have proxies like a radio action. | 
Since 2.4
"active" property"active" gboolean : Read / Write
Whether the toggle action should be active.
Default value: FALSE
Since 2.10
"draw-as-radio" property"draw-as-radio" gboolean : Read / Write
Whether the proxies for this action look like radio action proxies.
This is an appearance property and thus only applies if
"use-action-appearance" is TRUE.
Default value: FALSE
"toggled" signalvoid                user_function                      (GtkToggleAction *toggleaction,
                                                        gpointer         user_data)         : Run First
Should be connected if you wish to perform an action whenever the GtkToggleAction state is changed.
| 
 | the object which received the signal. | 
| 
 | user data set when the signal handler was connected. |