Check Boxes
===========

..
  image:: ../../img/tutorials/component.png

Check boxes are buttons that display a "checked" indicator next to their
label.

* `Interface guidelines <https://developer.gnome.org/hig/patterns/controls/checkboxes.html>`__

.. tabs::

   .. code-tab:: c

      GtkWidget *check = gtk_check_button_new_with_label ("Show title");

      // "on_toggled" is defined elsewhere
      g_signal_connect (check, "toggled", G_CALLBACK (on_toggled), NULL);

   .. code-tab:: python

      check = Gtk.CheckButton(label="Show title")

      # "on_toggled" is defined elsewhere
      check.connect("toggled", on_toggled)

   .. code-tab:: vala

      var check = new Gtk.CheckButton.with_label ("Show title");

      // "on_toggled" is defined elsewhere
      check.toggled.connect (on_toggled);

   .. code-tab:: js

      const check = new Gtk.CheckButton({ label: "Show title" });

      // "on_toggled" is defined elsewhere
      check.connect("toggled", on_toggled);


Useful methods for the component
--------------------------------

* Check boxes can be set to an "inconsistent" state: a state that is neither
  active nor inactive. You can use the ``set_inconsistent()`` method to set
  this state.
* If you want to enable a mnemonic shortcut for your check box, you can use
  the ``new_with_mnemonic()`` constructor, or the ``set_use_underline()``
  method.


API references
--------------

In the examples we used the following classes:

* `GtkCheckButton <https://docs.gtk.org/gtk4/class.CheckButton.html>`__