gtk.CheckButton — a toggle button widget styled as a checkbox and label


class gtk.CheckButton(gtk.ToggleButton):
    gtk.CheckButton(label=None, use_underline=True)


+-- gobject.GObject
   +-- gtk.Object
      +-- gtk.Widget
         +-- gtk.Container
            +-- gtk.Bin
               +-- gtk.Button
                  +-- gtk.ToggleButton
                     +-- gtk.CheckButton

Implemented Interfaces

gtk.CheckButton implements gtk.Buildable

gtk.CheckButton Style Properties

gtk.Widget Style Properties

gtk.Button Style Properties

"indicator-size"Read/WriteThe size of the check or radio indicator
"indicator-spacing"Read/WriteThe spacing around the check or radio indicator


A gtk.CheckButton places a discrete gtk.ToggleButton next to a widget, (usually a gtk.Label). See the section on gtk.ToggleButton widgets for more information about toggle and check buttons. The signal ('toggled') is also inherited from gtk.ToggleButton.


    gtk.CheckButton(label=None, use_underline=True)

label :

a string to be used as the label text or None

use_underline :

if True, an underscore in the label text indicates the next character should be underlined and used for the mnemonic accelerator key if it is the first character so marked. Available in PyGTK 2.4 and above.

Returns :

a new checkbutton object

Creates a new checkbutton with a text label specified by label. If label is None or not specified then no label is created. If label contains underscore characters then the character following the underscore will be underlined and the character following the first underscore will be used as the mnemonic keyboard accelerator.

In PyGTK 2.4 and above the use_underline parameter is available and defaults to True. If use_underline is set to False the label text will not be parsed for mnemonic characters.