Top |
Object Hierarchy
GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkButton ╰── GtkToggleButton ╰── GtkCheckButton ╰── GtkRadioButton
Implemented Interfaces
GtkCheckButton implements AtkImplementorIface, GtkBuildable, GtkActionable and GtkActivatable.
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_with_label ()
GtkWidget *
gtk_check_button_new_with_label (const gchar *label
);
Creates a new GtkCheckButton with a GtkLabel to the right of it.
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.
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