## GtkCheckButton

GtkCheckButton — Create widgets with a discrete toggle button

## Synopsis

    #include <gtk/gtk.h>

                        GtkCheckButton;
    GtkWidget*          gtk_check_button_new                (void);
    GtkWidget*          gtk_check_button_new_with_label     (const gchar *label);
    GtkWidget*          gtk_check_button_new_with_mnemonic  (const gchar *label);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkButton
                                           +----GtkToggleButton
                                                 +----GtkCheckButton
                                                       +----GtkRadioButton

## Implemented Interfaces

GtkCheckButton implements AtkImplementorIface, GtkBuildable and GtkActivatable.

## Style Properties

      "indicator-size"           gint                  : Read
      "indicator-spacing"        gint                  : Read

## Description

A GtkCheckButton places a discrete GtkToggleButton next to a widget, (usually a GtkLabel). See the section on GtkToggleButton widgets for more information about toggle/check buttons.

The important signal ('toggled') is also inherited from GtkToggleButton.

## Details

### GtkCheckButton

    typedef struct _GtkCheckButton GtkCheckButton;

`toggle_button` is a GtkToggleButton representing the actual toggle button that composes the check button.

### gtk_check_button_new ()

    GtkWidget*          gtk_check_button_new                (void);

Creates a new GtkCheckButton.

Returns : | a GtkWidget.

### gtk_check_button_new_with_label ()

    GtkWidget*          gtk_check_button_new_with_label     (const gchar *label);

Creates a new GtkCheckButton with a GtkLabel to the right of it.

`label` : | the text for the check button.
Returns : | a GtkWidget.

### gtk_check_button_new_with_mnemonic ()

    GtkWidget*          gtk_check_button_new_with_mnemonic  (const gchar *label);

Creates a new GtkCheckButton containing a label. The label will be created using `gtk_label_new_with_mnemonic()`, so underscores in `label` indicate the mnemonic for the check button.

`label` : | The text of the button, with an underscore in front of the mnemonic character
Returns : | a new GtkCheckButton

## Style Property Details

### The `"indicator-size"` style property

      "indicator-size"           gint                  : Read

Size of check or radio indicator.

Allowed values: >= 0

Default value: 13

### The `"indicator-spacing"` style property

      "indicator-spacing"        gint                  : Read

Spacing around check or radio indicator.

Allowed values: >= 0

Default value: 2

## See Also

GtkCheckMenuItem | add check buttons to your menus.
GtkButton | a more general button.
GtkToggleButton | GtkCheckButton's parent.
GtkRadioButton | group check buttons together.