GTK+ Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# GtkCheckButton

## Name

GtkCheckButton -- create widgets with a discrete toggle button.

## Synopsis

    #include <gtk/gtk.h>

    struct      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
       +----GtkObject
             +----GtkWidget
                   +----GtkContainer
                         +----GtkBin
                               +----GtkButton
                                     +----GtkToggleButton
                                           +----GtkCheckButton

## Style Properties

      "indicator-spacing"    gint                 : Read
      "indicator-size"       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

### struct GtkCheckButton

    struct 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 Properties

"`indicator-spacing`" (gint : Read)

  Spacing around check or radio indicator

"`indicator-size`" (gint : Read)

  Size of check or radio indicator

## See Also

GtkCheckMenuItem

  add check buttons to your menus.

GtkButton

  a more general button.

GtkToggleButton

  GtkCheckButton's parent.

GtkRadioButton

  group check buttons together.

<<< Previous Page | Home | Up | Next Page >>>
GtkButton | GtkRadioButton