manpagez: man pages & more
html files: gtk
Home | html | info | man


GtkCheckButton — Create widgets with a discrete toggle button

Object Hierarchy


Implemented Interfaces

GtkCheckButton implements GtkActivatable, AtkImplementorIface and GtkBuildable.

Style Properties

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


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.



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


add check buttons to your menus.


a more general button.


GtkCheckButton's parent.


group check buttons together.

© 2000-2015
Individual documents may contain additional copyright information.