Gtk.CheckButton – gtk4 Reference Manual

CheckButton

Object Hierarchy:

Description:

[ CCode ( type_id = "gtk_check_button_get_type ()" ) ]
public class CheckButton : Widget, Accessible, Actionable, Buildable, ConstraintTarget

A `GtkCheckButton` places a label next to an indicator.

![Example GtkCheckButtons](check-button.png)

A `GtkCheckButton` is created by calling either [[email protected]] or [[email protected]_with_label].

The state of a `GtkCheckButton` can be set specifically using [[email protected]_active], and retrieved using [ [email protected]_active].

Inconsistent state

In addition to "on" and "off", check buttons can be an "in between" state that is neither on nor off. This can be used e.g. when the user has selected a range of elements (such as some text or spreadsheet cells) that are affected by a check button, and the current values in that range are inconsistent.

To set a `GtkCheckButton` to inconsistent state, use [[email protected]_inconsistent].

Grouping

Check buttons can be grouped together, to form mutually exclusive groups - only one of the buttons can be toggled at a time, and toggling another one will switch the currently toggled one off.

Grouped check buttons use a different indicator, and are commonly referred to as *radio buttons*.

![Example GtkCheckButtons](radio-button.png)

To add a `GtkCheckButton` to a group, use [[email protected]_group].

CSS nodes

``` checkbutton[.text-button] ├── check ╰── [label] ```

A `GtkCheckButton` has a main node with name checkbutton. If the [[email protected]:label] or [[email protected]:child] properties are set, it contains a child widget. The indicator node is named check when no group is set, and radio if the checkbutton is grouped together with other checkbuttons.

Accessibility

`GtkCheckButton` uses the gtk_accessible_role_checkbox role.

Namespace: Gtk

Package: gtk4

Content:

Properties:

public bool active { get; set; }
If the check button is active.
public Widget child { get; set; }
The child widget.
public CheckButton group { set; }
The check button whose group this widget belongs to.
public bool inconsistent { get; set; }
If the check button is in an “in between” state.
public string label { get; set; }
Text of the label inside the check button, if it contains a label widget.
public bool use_underline { get; set; }
If set, an underline in the text indicates that the following character is to be used as mnemonic.

Creation methods:

public CheckButton ()
Creates a new `GtkCheckButton`.
public CheckButton.with_label (string? label)
Creates a new `GtkCheckButton` with the given text.
public CheckButton.with_mnemonic (string? label)
Creates a new `GtkCheckButton` with the given text and a mnemonic.

Methods:

public bool get_active ()
Returns whether the check button is active.
public unowned Widget? get_child ()
Gets the child widget of this or `NULL` if [property@CheckButton:label] is set.
public bool get_inconsistent ()
Returns whether the check button is in an inconsistent state.
public unowned string? get_label ()
Returns the label of the check button or `NULL` if [ property@CheckButton:child] is set.
public bool get_use_underline ()
Returns whether underlines in the label indicate mnemonics.
public void set_active (bool setting)
Changes the check buttons active state.
public void set_child (Widget? child)
Sets the child widget of this.
public void set_group (CheckButton? group)
Adds this to the group of group.
public void set_inconsistent (bool inconsistent)
Sets the `GtkCheckButton` to inconsistent state.
public void set_label (string? label)
Sets the text of this.
public void set_use_underline (bool setting)
Sets whether underlines in the label indicate mnemonics.

Signals:

public virtual signal void activate ()
Emitted to when the check button is activated.
public virtual signal void toggled ()
Emitted when the buttons's [property@Gtk.

Inherited Members:

All known members inherited from class Gtk.Widget

All known members inherited from class GLib.Object

@get
@new
@ref
@set
add_toggle_ref
add_weak_pointer
bind_property
connect
constructed
disconnect
dispose
dup_data
dup_qdata
force_floating
freeze_notify
get_class
get_data

get_property
get_qdata
get_type
getv
interface_find_property
interface_install_property
interface_list_properties
is_floating
new_valist
new_with_properties
newv
notify
notify_property
ref_count
ref_sink
remove_toggle_ref
remove_weak_pointer

replace_data
replace_qdata
set_data
set_data_full
set_property
set_qdata
set_qdata_full
set_valist
setv
steal_data
steal_qdata
thaw_notify
unref
watch_closure
weak_ref
weak_unref

All known members inherited from interface Gtk.Accessible

All known members inherited from interface Gtk.Actionable

All known members inherited from interface Gtk.Buildable

2022 vala-language.org