Merge branch 'ebassi/docs-for-main' into 'main'

docs: Clean up the ToggleButton description

See merge request GNOME/gtk!4347
This commit is contained in:
Timm Bäder 2022-01-07 16:25:41 +00:00
commit e602768794

View File

@ -55,7 +55,7 @@
* To simply switch the state of a toggle button, use * To simply switch the state of a toggle button, use
* [method@Gtk.ToggleButton.toggled]. * [method@Gtk.ToggleButton.toggled].
* *
* # Grouping * ## Grouping
* *
* Toggle buttons can be grouped together, to form mutually exclusive * Toggle buttons can be grouped together, to form mutually exclusive
* groups - only one of the buttons can be toggled at a time, and toggling * groups - only one of the buttons can be toggled at a time, and toggling
@ -63,20 +63,25 @@
* *
* To add a `GtkToggleButton` to a group, use [method@Gtk.ToggleButton.set_group]. * To add a `GtkToggleButton` to a group, use [method@Gtk.ToggleButton.set_group].
* *
* # CSS nodes * ## CSS nodes
* *
* `GtkToggleButton` has a single CSS node with name button. To differentiate * `GtkToggleButton` has a single CSS node with name button. To differentiate
* it from a plain `GtkButton`, it gets the .toggle style class. * it from a plain `GtkButton`, it gets the `.toggle` style class.
* *
* ## Creating two `GtkToggleButton` widgets. * ## Creating two `GtkToggleButton` widgets.
* *
* ```c * ```c
* static void output_state (GtkToggleButton *source, gpointer user_data) * static void
* output_state (GtkToggleButton *source,
* gpointer user_data)
* { * {
* printf ("Active: %d\n", gtk_toggle_button_get_active (source)); * g_print ("Toggle button "%s" is active: %s",
* gtk_button_get_label (GTK_BUTTON (source)),
* gtk_toggle_button_get_active (source) ? "Yes" : "No");
* } * }
* *
* void make_toggles (void) * static void
* make_toggles (void)
* { * {
* GtkWidget *window, *toggle1, *toggle2; * GtkWidget *window, *toggle1, *toggle2;
* GtkWidget *box; * GtkWidget *box;
@ -85,7 +90,7 @@
* window = gtk_window_new (); * window = gtk_window_new ();
* box = gtk_box_new (GTK_ORIENTATION_VERTICAL, 12); * box = gtk_box_new (GTK_ORIENTATION_VERTICAL, 12);
* *
* text = "Hi, Im a toggle button."; * text = "Hi, Im toggle button one";
* toggle1 = gtk_toggle_button_new_with_label (text); * toggle1 = gtk_toggle_button_new_with_label (text);
* *
* g_signal_connect (toggle1, "toggled", * g_signal_connect (toggle1, "toggled",
@ -93,7 +98,7 @@
* NULL); * NULL);
* gtk_box_append (GTK_BOX (box), toggle1); * gtk_box_append (GTK_BOX (box), toggle1);
* *
* text = "Hi, Im a toggle button."; * text = "Hi, Im toggle button two";
* toggle2 = gtk_toggle_button_new_with_label (text); * toggle2 = gtk_toggle_button_new_with_label (text);
* g_signal_connect (toggle2, "toggled", * g_signal_connect (toggle2, "toggled",
* G_CALLBACK (output_state), * G_CALLBACK (output_state),