## GtkToggleAction

GtkToggleAction — An action which can be toggled between two states

## Synopsis

    #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);

## Object Hierarchy

      GObject
       +----GtkAction
             +----GtkToggleAction
                   +----GtkRadioAction

## Implemented Interfaces

GtkToggleAction implements GtkBuildable.

## Properties

      "active"                   gboolean              : Read / Write
      "draw-as-radio"            gboolean              : Read / Write

## Signals

      "toggled"                                        : Run First

## Description

A GtkToggleAction corresponds roughly to a GtkCheckMenuItem. It has an "active" state specifying whether the action has been checked or not.

## Details

### struct GtkToggleAction

    struct GtkToggleAction;

### gtk_toggle_action_new ()

    GtkToggleAction *   gtk_toggle_action_new               (const gchar *name,
                                                             const gchar *label,
                                                             const gchar *tooltip,
                                                             const gchar *stock_id);

### Warning

`gtk_toggle_action_new` is deprecated and should not be used in newly-written code. 3.10

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

`name` : | A unique name for the action
`label` : | The label displayed in menu items and on buttons, or `NULL`. [allow-none]
`tooltip` : | A tooltip for the action, or `NULL`. [allow-none]
`stock_id` : | The stock icon to display in widgets representing the action, or `NULL`. [allow-none]
Returns : | a new GtkToggleAction

Since 2.4

### gtk_toggle_action_toggled ()

    void                gtk_toggle_action_toggled           (GtkToggleAction *action);

### Warning

`gtk_toggle_action_toggled` is deprecated and should not be used in newly-written code. 3.10

Emits the "toggled" signal on the toggle action.

`action` : | the action object

Since 2.4

### gtk_toggle_action_set_active ()

    void                gtk_toggle_action_set_active        (GtkToggleAction *action,
                                                             gboolean is_active);

### Warning

`gtk_toggle_action_set_active` is deprecated and should not be used in newly-written code. 3.10

Sets the checked state on the toggle action.

`action` : | the action object
`is_active` : | whether the action should be checked or not

Since 2.4

### gtk_toggle_action_get_active ()

    gboolean            gtk_toggle_action_get_active        (GtkToggleAction *action);

### Warning

`gtk_toggle_action_get_active` is deprecated and should not be used in newly-written code. 3.10

Returns the checked state of the toggle action.

`action` : | the action object
Returns : | the checked state of the toggle action

Since 2.4

### gtk_toggle_action_set_draw_as_radio ()

    void                gtk_toggle_action_set_draw_as_radio (GtkToggleAction *action,
                                                             gboolean draw_as_radio);

### Warning

`gtk_toggle_action_set_draw_as_radio` is deprecated and should not be used in newly-written code. 3.10

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

`action` : | the action object
`draw_as_radio` : | whether the action should have proxies like a radio action

Since 2.4

### gtk_toggle_action_get_draw_as_radio ()

    gboolean            gtk_toggle_action_get_draw_as_radio (GtkToggleAction *action);

### Warning

`gtk_toggle_action_get_draw_as_radio` is deprecated and should not be used in newly-written code. 3.10

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

`action` : | the action object
Returns : | whether the action should have proxies like a radio action.

Since 2.4

## Property Details

### The `"active"` property

      "active"                   gboolean              : Read / Write

### Warning

`GtkToggleAction:active` is deprecated and should not be used in newly-written code. 3.10

Whether the toggle action should be active.

Default value: FALSE

Since 2.10

### The `"draw-as-radio"` property

      "draw-as-radio"            gboolean              : Read / Write

### Warning

`GtkToggleAction:draw-as-radio` is deprecated and should not be used in newly-written code. 3.10

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

## Signal Details

### The `"toggled"` signal

    void                user_function                      (GtkToggleAction *toggleaction,
                                                            gpointer         user_data)         : Run First

### Warning

`GtkToggleAction::toggled` is deprecated and should not be used in newly-written code. 3.10

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

`toggleaction` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.