GtkCheckButton

GtkCheckButton — Create widgets with a discrete toggle button

Functions

Style Properties

int indicator-size Read
int indicator-spacing Read

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkButton
                        ╰── GtkToggleButton
                            ╰── GtkCheckButton
                                ╰── GtkRadioButton

Implemented Interfaces

GtkCheckButton implements AtkImplementorIface, GtkBuildable, GtkActionable and GtkActivatable.

Includes

#include <gtk/gtk.h>

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.

CSS nodes

1
2
3
checkbutton
├── check
╰── <child>

A GtkCheckButton with indicator (see gtk_toggle_button_set_mode()) has a main CSS node with name checkbutton and a subnode with name check.

1
2
3
button.check
├── check
╰── <child>

A GtkCheckButton without indicator changes the name of its main node to button and adds a .check style class to it. The subnode is invisible in this case.

Functions

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.

Parameters

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.

Parameters

label

The text of the button, with an underscore in front of the mnemonic character

 

Returns

a new GtkCheckButton

Types and Values

struct GtkCheckButton

struct GtkCheckButton;

Style Property Details

The “indicator-size” style property

  “indicator-size”           int

The size of the indicator.

GtkCheckButton:indicator-size has been deprecated since version 3.20 and should not be used in newly-written code.

Use CSS min-width and min-height on the indicator node.

Owner: GtkCheckButton

Flags: Read

Allowed values: >= 0

Default value: 16


The “indicator-spacing” style property

  “indicator-spacing”        int

The spacing around the indicator.

GtkCheckButton:indicator-spacing has been deprecated since version 3.20 and should not be used in newly-written code.

Use CSS margins of the indicator node, the value of this style property is ignored.

Owner: GtkCheckButton

Flags: Read

Allowed values: >= 0

Default value: 2

See Also

GtkCheckMenuItem, GtkButton, GtkToggleButton, GtkRadioButton