--- /dev/null
+/*
+ * GTK - The GIMP Toolkit
+ * Copyright (C) 2022 Red Hat, Inc.
+ * All rights reserved.
+ *
+ * This Library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public License as
+ * published by the Free Software Foundation; either version 2 of the
+ * License, or (at your option) any later version.
+ *
+ * This Library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include "config.h"
+
+#include "gtkfontdialogbutton.h"
+
+#include "gtkbinlayout.h"
+#include "gtkbox.h"
+#include "gtkseparator.h"
+#include "gtkbutton.h"
+#include "gtklabel.h"
+#include <glib/gi18n-lib.h>
+#include "gtkmain.h"
+#include "gtkprivate.h"
+#include "gtkwidgetprivate.h"
+#include "gtktypebuiltins.h"
+
+
+static void button_clicked (GtkFontDialogButton *self);
+static void update_button_sensitivity
+ (GtkFontDialogButton *self);
+
+/**
+ * GtkFontDialogButton:
+ *
+ * The `GtkFontDialogButton` is wrapped around a [class@Gtk.FontDialog]
+ * and allows to open a font chooser dialog to change the font.
+ *
+ * 
+ *
+ * It is suitable widget for selecting a font in a preference dialog.
+ *
+ * # CSS nodes
+ *
+ * ```
+ * fontbutton
+ * ╰── button.font
+ * ╰── [content]
+ * ```
+ *
+ * `GtkFontDialogButton` has a single CSS node with name fontbutton which
+ * contains a button node with the .font style class.
+ */
+
+/* {{{ GObject implementation */
+
+struct _GtkFontDialogButton
+{
+ GtkWidget parent_instance;
+
+ GtkWidget *button;
+ GtkWidget *font_label;
+ GtkWidget *size_label;
+ GtkWidget *font_size_box;
+
+ GtkFontLevel level;
+
+ guint use_font : 1;
+ guint use_size : 1;
+
+ GtkFontDialog *dialog;
+ GCancellable *cancellable;
+ PangoFontDescription *font_desc;
+ char *font_features;
+ PangoLanguage *language;
+
+ PangoFontFamily *font_family;
+ PangoFontFace *font_face;
+};
+
+/* Properties */
+enum
+{
+ PROP_DIALOG = 1,
+ PROP_LEVEL,
+ PROP_FONT_DESC,
+ PROP_FONT_FEATURES,
+ PROP_LANGUAGE,
+ PROP_USE_FONT,
+ PROP_USE_SIZE,
+ NUM_PROPERTIES
+};
+
+static GParamSpec *properties[NUM_PROPERTIES];
+
+G_DEFINE_TYPE (GtkFontDialogButton, gtk_font_dialog_button, GTK_TYPE_WIDGET)
+
+static void
+gtk_font_dialog_button_init (GtkFontDialogButton *self)
+{
+ GtkWidget *box;
+ PangoFontDescription *font_desc;
+
+ self->button = gtk_button_new ();
+ g_signal_connect_swapped (self->button, "clicked", G_CALLBACK (button_clicked), self);
+ self->font_label = gtk_label_new (_("Font"));
+ gtk_widget_set_hexpand (self->font_label, TRUE);
+ self->size_label = gtk_label_new ("14");
+ self->font_size_box = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 0);
+
+ box = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 0);
+ gtk_box_append (GTK_BOX (box), self->font_label);
+
+ gtk_box_append (GTK_BOX (self->font_size_box), gtk_separator_new (GTK_ORIENTATION_VERTICAL));
+ gtk_box_append (GTK_BOX (self->font_size_box), self->size_label);
+ gtk_box_append (GTK_BOX (box), self->font_size_box);
+
+ gtk_button_set_child (GTK_BUTTON (self->button), box);
+ gtk_widget_set_parent (self->button, GTK_WIDGET (self));
+
+ self->level = GTK_FONT_LEVEL_FONT;
+
+ self->use_font = FALSE;
+ self->use_size = FALSE;
+
+ font_desc = pango_font_description_from_string ("Sans 12");
+ gtk_font_dialog_button_set_font_desc (self, font_desc);
+ pango_font_description_free (font_desc);
+
+ gtk_widget_add_css_class (self->button, "font");
+}
+
+static void
+gtk_font_dialog_button_unroot (GtkWidget *widget)
+{
+ GtkFontDialogButton *self = GTK_FONT_DIALOG_BUTTON (widget);
+
+ if (self->cancellable)
+ {
+ g_cancellable_cancel (self->cancellable);
+ g_clear_object (&self->cancellable);
+ update_button_sensitivity (self);
+ }
+
+ GTK_WIDGET_CLASS (gtk_font_dialog_button_parent_class)->unroot (widget);
+}
+
+static void
+gtk_font_dialog_button_set_property (GObject *object,
+ unsigned int param_id,
+ const GValue *value,
+ GParamSpec *pspec)
+{
+ GtkFontDialogButton *self = GTK_FONT_DIALOG_BUTTON (object);
+
+ switch (param_id)
+ {
+ case PROP_DIALOG:
+ gtk_font_dialog_button_set_dialog (self, g_value_get_object (value));
+ break;
+
+ case PROP_LEVEL:
+ gtk_font_dialog_button_set_level (self, g_value_get_enum (value));
+ break;
+
+ case PROP_FONT_DESC:
+ gtk_font_dialog_button_set_font_desc (self, g_value_get_boxed (value));
+ break;
+
+ case PROP_FONT_FEATURES:
+ gtk_font_dialog_button_set_font_features (self, g_value_get_string (value));
+ break;
+
+ case PROP_LANGUAGE:
+ gtk_font_dialog_button_set_language (self, g_value_get_boxed (value));
+ break;
+
+ case PROP_USE_FONT:
+ gtk_font_dialog_button_set_use_font (self, g_value_get_boolean (value));
+ break;
+
+ case PROP_USE_SIZE:
+ gtk_font_dialog_button_set_use_size (self, g_value_get_boolean (value));
+ break;
+
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
+ break;
+ }
+}
+
+static void
+gtk_font_dialog_button_get_property (GObject *object,
+ unsigned int param_id,
+ GValue *value,
+ GParamSpec *pspec)
+{
+ GtkFontDialogButton *self = GTK_FONT_DIALOG_BUTTON (object);
+
+ switch (param_id)
+ {
+ case PROP_DIALOG:
+ g_value_set_object (value, self->dialog);
+ break;
+
+ case PROP_LEVEL:
+ g_value_set_enum (value, self->level);
+ break;
+
+ case PROP_FONT_DESC:
+ g_value_set_boxed (value, self->font_desc);
+ break;
+
+ case PROP_FONT_FEATURES:
+ g_value_set_string (value, self->font_features);
+ break;
+
+ case PROP_LANGUAGE:
+ g_value_set_boxed (value, self->language);
+ break;
+
+ case PROP_USE_FONT:
+ g_value_set_boolean (value, self->use_font);
+ break;
+
+ case PROP_USE_SIZE:
+ g_value_set_boolean (value, self->use_size);
+ break;
+
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
+ break;
+ }
+}
+
+static void
+gtk_font_dialog_button_dispose (GObject *object)
+{
+ GtkFontDialogButton *self = GTK_FONT_DIALOG_BUTTON (object);
+
+ g_clear_pointer (&self->button, gtk_widget_unparent);
+
+ G_OBJECT_CLASS (gtk_font_dialog_button_parent_class)->dispose (object);
+}
+
+static void
+gtk_font_dialog_button_finalize (GObject *object)
+{
+ GtkFontDialogButton *self = GTK_FONT_DIALOG_BUTTON (object);
+
+ g_assert (self->cancellable == NULL);
+ g_clear_object (&self->dialog);
+ pango_font_description_free (self->font_desc);
+ g_clear_object (&self->font_family);
+ g_clear_object (&self->font_face);
+ g_free (self->font_features);
+
+ G_OBJECT_CLASS (gtk_font_dialog_button_parent_class)->finalize (object);
+}
+
+static void
+gtk_font_dialog_button_class_init (GtkFontDialogButtonClass *class)
+{
+ GObjectClass *object_class = G_OBJECT_CLASS (class);
+ GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (class);
+
+ object_class->get_property = gtk_font_dialog_button_get_property;
+ object_class->set_property = gtk_font_dialog_button_set_property;
+ object_class->dispose = gtk_font_dialog_button_dispose;
+ object_class->finalize = gtk_font_dialog_button_finalize;
+
+ widget_class->grab_focus = gtk_widget_grab_focus_child;
+ widget_class->focus = gtk_widget_focus_child;
+ widget_class->unroot = gtk_font_dialog_button_unroot;
+
+ /**
+ * GtkFontDialogButton:dialog: (attributes org.gtk.Property.get=gtk_font_dialog_button_get_dialog org.gtk.Property.set=gtk_font_dialog_button_set_dialog)
+ *
+ * The `GtkFontDialog` that contains parameters for
+ * the font chooser dialog.
+ *
+ * Since: 4.10
+ */
+ properties[PROP_DIALOG] =
+ g_param_spec_object ("dialog", NULL, NULL,
+ GTK_TYPE_FONT_DIALOG,
+ G_PARAM_READWRITE|G_PARAM_STATIC_STRINGS|G_PARAM_EXPLICIT_NOTIFY);
+
+ /**
+ * GtkFontDialogButton:level: (attributes org.gtk.Property.get=gtk_font_dialog_button_get_level org.gtk.Property.set=gtk_font_dialog_button_set_level)
+ *
+ * The level of detail for the font chooser dialog.
+ */
+ properties[PROP_LEVEL] =
+ g_param_spec_enum ("level", NULL, NULL,
+ GTK_TYPE_FONT_LEVEL,
+ GTK_FONT_LEVEL_FONT,
+ GTK_PARAM_READWRITE|G_PARAM_STATIC_STRINGS|G_PARAM_EXPLICIT_NOTIFY);
+
+ /**
+ * GtkFontDialogButton:font-desc: (attributes org.gtk.Property.get=gtk_font_dialog_button_get_font_desc org.gtk.Property.set=gtk_font_dialog_button_set_font_desc)
+ *
+ * The selected font.
+ *
+ * This property can be set to give the button its initial
+ * font, and it will be updated to reflect the users choice
+ * in the font chooser dialog.
+ *
+ * Listen to `notify::font-desc` to get informed about changes
+ * to the buttons font.
+ *
+ * Since: 4.10
+ */
+ properties[PROP_FONT_DESC] =
+ g_param_spec_boxed ("font-desc", NULL, NULL,
+ PANGO_TYPE_FONT_DESCRIPTION,
+ G_PARAM_READWRITE|G_PARAM_STATIC_STRINGS|G_PARAM_EXPLICIT_NOTIFY);
+
+ /**
+ * GtkFontDialogButton:font-features: (attributes org.gtk.Property.get=gtk_font_dialog_button_get_font_features org.gtk.Property.set=gtk_font_dialog_button_set_font_features)
+ *
+ * The selected font features.
+ *
+ * This property will be updated to reflect the users choice
+ * in the font chooser dialog.
+ *
+ * Listen to `notify::font-features` to get informed about changes
+ * to the buttons font features.
+ *
+ * Since: 4.10
+ */
+ properties[PROP_FONT_FEATURES] =
+ g_param_spec_string ("font-features", NULL, NULL,
+ NULL,
+ G_PARAM_READWRITE|G_PARAM_STATIC_STRINGS|G_PARAM_EXPLICIT_NOTIFY);
+
+ /**
+ * GtkFontDialogButton:language: (attributes org.gtk.Property.get=gtk_font_dialog_button_get_language org.gtk.Property.set=gtk_font_dialog_button_set_language)
+ *
+ * The selected language for font features.
+ *
+ * This property will be updated to reflect the users choice
+ * in the font chooser dialog.
+ *
+ * Listen to `notify::language` to get informed about changes
+ * to the buttons language.
+ *
+ * Since: 4.10
+ */
+ properties[PROP_LANGUAGE] =
+ g_param_spec_boxed ("language", NULL, NULL,
+ PANGO_TYPE_LANGUAGE,
+ G_PARAM_READWRITE|G_PARAM_STATIC_STRINGS|G_PARAM_EXPLICIT_NOTIFY);
+
+ /**
+ * GtkFontDialogButton:use-font: (attributes org.gtk.Property.get=gtk_font_dialog_button_get_use_font org.gtk.Property.set=gtk_font_dialog_button_set_use_font)
+ *
+ * Whether the buttons label will be drawn in the selected font.
+ */
+ properties[PROP_USE_FONT] =
+ g_param_spec_boolean ("use-font", NULL, NULL,
+ FALSE,
+ GTK_PARAM_READWRITE|G_PARAM_STATIC_STRINGS|G_PARAM_EXPLICIT_NOTIFY);
+
+ /**
+ * GtkFontDialogButton:use-size: (attributes org.gtk.Property.get=gtk_font_dialog_button_get_use_size org.gtk.Property.set=gtk_font_dialog_button_set_use_size)
+ *
+ * Whether the buttons label will use the selected font size.
+ */
+ properties[PROP_USE_SIZE] =
+ g_param_spec_boolean ("use-size", NULL, NULL,
+ FALSE,
+ GTK_PARAM_READWRITE|G_PARAM_STATIC_STRINGS|G_PARAM_EXPLICIT_NOTIFY);
+
+ g_object_class_install_properties (object_class, NUM_PROPERTIES, properties);
+
+ gtk_widget_class_set_layout_manager_type (widget_class, GTK_TYPE_BIN_LAYOUT);
+ gtk_widget_class_set_css_name (widget_class, "fontbutton");
+}
+
+/* }}} */
+/* {{{ Private API, callbacks */
+
+static void
+update_button_sensitivity (GtkFontDialogButton *self)
+{
+ gtk_widget_set_sensitive (self->button,
+ self->dialog != NULL && self->cancellable == NULL);
+}
+
+static void
+family_chosen (GObject *source,
+ GAsyncResult *result,
+ gpointer data)
+{
+ GtkFontDialogButton *self = data;
+ PangoFontFamily *family;
+
+ family = gtk_font_dialog_choose_family_finish (self->dialog, result, NULL);
+ if (family)
+ {
+ PangoFontDescription *desc;
+
+ desc = pango_font_description_new ();
+ pango_font_description_set_family (desc, pango_font_family_get_name (family));
+
+ gtk_font_dialog_button_set_font_desc (self, desc);
+
+ pango_font_description_free (desc);
+ g_object_unref (family);
+ }
+
+ g_clear_object (&self->cancellable);
+ update_button_sensitivity (self);
+}
+
+static void
+face_chosen (GObject *source,
+ GAsyncResult *result,
+ gpointer data)
+{
+ GtkFontDialogButton *self = data;
+ PangoFontFace *face;
+
+ face = gtk_font_dialog_choose_face_finish (self->dialog, result, NULL);
+ if (face)
+ {
+ PangoFontDescription *desc;
+
+ desc = pango_font_face_describe (face);
+
+ gtk_font_dialog_button_set_font_desc (self, desc);
+
+ pango_font_description_free (desc);
+ g_object_unref (face);
+ }
+
+ g_clear_object (&self->cancellable);
+ update_button_sensitivity (self);
+}
+
+static void
+font_chosen (GObject *source,
+ GAsyncResult *result,
+ gpointer data)
+{
+ GtkFontDialogButton *self = data;
+ PangoFontDescription *desc;
+
+ desc = gtk_font_dialog_choose_font_finish (self->dialog, result, NULL);
+ if (desc)
+ {
+ gtk_font_dialog_button_set_font_desc (self, desc);
+ pango_font_description_free (desc);
+ }
+
+ g_clear_object (&self->cancellable);
+ update_button_sensitivity (self);
+}
+
+static void
+font_and_features_chosen (GObject *source,
+ GAsyncResult *result,
+ gpointer data)
+{
+ GtkFontDialogButton *self = data;
+ PangoFontDescription *desc;
+ char *features;
+ PangoLanguage *language;
+
+ if (gtk_font_dialog_choose_font_and_features_finish (self->dialog, result,
+ &desc, &features, &language,
+ NULL))
+ {
+ gtk_font_dialog_button_set_font_desc (self, desc);
+ gtk_font_dialog_button_set_font_features (self, features);
+ gtk_font_dialog_button_set_language (self, language);
+
+ pango_font_description_free (desc);
+ g_free (features);
+ }
+
+ g_clear_object (&self->cancellable);
+ update_button_sensitivity (self);
+}
+
+static void
+button_clicked (GtkFontDialogButton *self)
+{
+ GtkRoot *root = gtk_widget_get_root (GTK_WIDGET (self));
+ GtkWindow *parent = NULL;
+
+ g_assert (self->cancellable == NULL);
+ self->cancellable = g_cancellable_new ();
+
+ update_button_sensitivity (self);
+
+ if (GTK_IS_WINDOW (root))
+ parent = GTK_WINDOW (root);
+
+ switch (self->level)
+ {
+ case GTK_FONT_LEVEL_FAMILY:
+ gtk_font_dialog_choose_family (self->dialog, parent, self->font_family,
+ self->cancellable, family_chosen, self);
+ break;
+
+ case GTK_FONT_LEVEL_FACE:
+ gtk_font_dialog_choose_face (self->dialog, parent, self->font_face,
+ self->cancellable, face_chosen, self);
+ break;
+
+ case GTK_FONT_LEVEL_FONT:
+ gtk_font_dialog_choose_font (self->dialog, parent, self->font_desc,
+ self->cancellable, font_chosen, self);
+ break;
+
+ case GTK_FONT_LEVEL_FEATURES:
+ gtk_font_dialog_choose_font_and_features (self->dialog, parent, self->font_desc,
+ self->cancellable, font_and_features_chosen, self);
+ break;
+
+ default:
+ g_assert_not_reached ();
+ }
+}
+
+static gboolean
+font_description_style_equal (const PangoFontDescription *a,
+ const PangoFontDescription *b)
+{
+ return (pango_font_description_get_weight (a) == pango_font_description_get_weight (b) &&
+ pango_font_description_get_style (a) == pango_font_description_get_style (b) &&
+ pango_font_description_get_stretch (a) == pango_font_description_get_stretch (b) &&
+ pango_font_description_get_variant (a) == pango_font_description_get_variant (b));
+}
+
+static void
+update_font_data (GtkFontDialogButton *self)
+{
+ PangoFontMap *fontmap = NULL;
+ const char *family_name;
+
+ g_assert (self->font_desc != NULL);
+
+ g_clear_object (&self->font_family);
+ g_clear_object (&self->font_face);
+
+ family_name = pango_font_description_get_family (self->font_desc);
+ if (family_name == NULL)
+ return;
+
+ if (self->dialog)
+ fontmap = gtk_font_dialog_get_font_map (self->dialog);
+ if (!fontmap)
+ fontmap = pango_cairo_font_map_get_default ();
+
+ for (unsigned int i = 0; i < g_list_model_get_n_items (G_LIST_MODEL (fontmap)); i++)
+ {
+ PangoFontFamily *family = g_list_model_get_item (G_LIST_MODEL (fontmap), i);
+ const char *name = pango_font_family_get_name (family);
+ g_object_unref (family);
+
+ if (g_ascii_strcasecmp (name, family_name) == 0)
+ {
+ g_set_object (&self->font_family, family);
+ break;
+ }
+ }
+
+ for (unsigned i = 0; i < g_list_model_get_n_items (G_LIST_MODEL (self->font_family)); i++)
+ {
+ PangoFontFace *face = g_list_model_get_item (G_LIST_MODEL (self->font_family), i);
+ PangoFontDescription *tmp_desc = pango_font_face_describe (face);
+ g_object_unref (face);
+
+ if (font_description_style_equal (tmp_desc, self->font_desc))
+ {
+ g_set_object (&self->font_face, face);
+ pango_font_description_free (tmp_desc);
+ break;
+ }
+ else
+ pango_font_description_free (tmp_desc);
+ }
+}
+
+static void
+update_font_info (GtkFontDialogButton *self)
+{
+ const char *fam_name;
+ const char *face_name;
+ char *family_style;
+ char *size;
+
+ if (self->font_family)
+ fam_name = pango_font_family_get_name (self->font_family);
+ else
+ fam_name = C_("font", "None");
+ if (self->font_face)
+ face_name = pango_font_face_get_face_name (self->font_face);
+ else
+ face_name = "";
+
+ if (self->level == GTK_FONT_LEVEL_FAMILY)
+ family_style = g_strdup (fam_name);
+ else
+ family_style = g_strconcat (fam_name, " ", face_name, NULL);
+
+ gtk_label_set_text (GTK_LABEL (self->font_label), family_style);
+ g_free (family_style);
+
+ if (self->level >= GTK_FONT_LEVEL_FONT)
+ {
+ /* mirror Pango, which doesn't translate this either */
+ size = g_strdup_printf ("%2.4g%s",
+ pango_font_description_get_size (self->font_desc) / (double)PANGO_SCALE,
+ pango_font_description_get_size_is_absolute (self->font_desc) ? "px" : "");
+
+ gtk_label_set_text (GTK_LABEL (self->size_label), size);
+ g_free (size);
+ gtk_widget_show (self->font_size_box);
+ }
+ else
+ gtk_widget_hide (self->font_size_box);
+}
+
+static void
+apply_use_font (GtkFontDialogButton *self)
+{
+ if (!self->use_font)
+ gtk_label_set_attributes (GTK_LABEL (self->font_label), NULL);
+ else
+ {
+ PangoFontDescription *desc;
+ PangoAttrList *attrs;
+ PangoLanguage *language;
+
+ desc = pango_font_description_copy (self->font_desc);
+
+ if (!self->use_size)
+ pango_font_description_unset_fields (desc, PANGO_FONT_MASK_SIZE);
+
+ attrs = pango_attr_list_new ();
+
+ /* Prevent font fallback */
+ pango_attr_list_insert (attrs, pango_attr_fallback_new (FALSE));
+
+ /* Force current font and features */
+ pango_attr_list_insert (attrs, pango_attr_font_desc_new (desc));
+ if (self->font_features)
+ pango_attr_list_insert (attrs, pango_attr_font_features_new (self->font_features));
+ if (self->language)
+ language = self->language;
+ else if (self->dialog)
+ language = gtk_font_dialog_get_language (self->dialog);
+ else
+ language = NULL;
+ if (language)
+ pango_attr_list_insert (attrs, pango_attr_language_new (language));
+
+ gtk_label_set_attributes (GTK_LABEL (self->font_label), attrs);
+
+ pango_attr_list_unref (attrs);
+ pango_font_description_free (desc);
+ }
+}
+
+/* }}} */
+/* {{{ Constructor */
+
+/**
+ * gtk_font_dialog_button_new:
+ * @dialog: (nullable) (transfer full): the `GtkFontDialog` to use
+ *
+ * Creates a new `GtkFontDialogButton` with the
+ * given `GtkFontDialog`.
+ *
+ * You can pass `NULL` to this function and set a `GtkFontDialog`
+ * later. The button will be insensitive until that happens.
+ *
+ * Returns: the new `GtkFontDialogButton`
+ *
+ * Since: 4.10
+ */
+GtkWidget *
+gtk_font_dialog_button_new (GtkFontDialog *dialog)
+{
+ GtkWidget *self;
+
+ g_return_val_if_fail (GTK_IS_FONT_DIALOG (dialog), NULL);
+
+ self = g_object_new (GTK_TYPE_FONT_DIALOG_BUTTON,
+ "dialog", dialog,
+ NULL);
+
+ g_clear_object (&dialog);
+
+ return self;
+}
+
+/* }}} */
+/* {{{ Getters and setters */
+
+/**
+ * gtk_font_dialog_button_set_dialog:
+ * @self: a `GtkFontDialogButton`
+ * @dialog: the new `GtkFontDialog`
+ *
+ * Sets a `GtkFontDialog` object to use for
+ * creating the font chooser dialog that is
+ * presented when the user clicks the button.
+ *
+ * Since: 4.10
+ */
+void
+gtk_font_dialog_button_set_dialog (GtkFontDialogButton *self,
+ GtkFontDialog *dialog)
+{
+ g_return_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self));
+ g_return_if_fail (dialog == NULL || GTK_IS_FONT_DIALOG (dialog));
+
+ if (!g_set_object (&self->dialog, dialog))
+ return;
+
+ update_button_sensitivity (self);
+
+ g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_DIALOG]);
+}
+
+/**
+ * gtk_font_dialog_button_get_dialog:
+ * @self: a `GtkFontDialogButton`
+ *
+ * Returns the `GtkFontDialog` of @self.
+ *
+ * Returns: (nullable) (transfer none): the `GtkFontDialog`
+ *
+ * Since: 4.10
+ */
+GtkFontDialog *
+gtk_font_dialog_button_get_dialog (GtkFontDialogButton *self)
+{
+ g_return_val_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self), NULL);
+
+ return self->dialog;
+}
+
+/**
+ * gtk_font_dialog_button_get_level:
+ * @self: a `GtkFontDialogButton
+ *
+ * Returns the level of detail at which this dialog
+ * lets the user select fonts.
+ *
+ * Returns: the level of detail
+ *
+ * Since: 4.10
+ */
+GtkFontLevel
+gtk_font_dialog_button_get_level (GtkFontDialogButton *self)
+{
+ g_return_val_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self), GTK_FONT_LEVEL_FONT);
+
+ return self->level;
+}
+
+/**
+ * gtk_font_dialog_button_set_level:
+ * @self: a `GtkFontDialogButton`
+ * @level: the level of detail
+ *
+ * Sets the level of detail at which this dialog
+ * lets the user select fonts.
+ *
+ * Since: 4.10
+ */
+void
+gtk_font_dialog_button_set_level (GtkFontDialogButton *self,
+ GtkFontLevel level)
+{
+ g_return_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self));
+
+ if (self->level == level)
+ return;
+
+ self->level = level;
+
+ g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_LEVEL]);
+}
+
+/**
+ * gtk_font_dialog_button_set_font_desc:
+ * @self: a `GtkFontDialogButton`
+ * @font_desc: the new font
+ *
+ * Sets the font of the button.
+ *
+ * Since: 4.10
+ */
+void
+gtk_font_dialog_button_set_font_desc (GtkFontDialogButton *self,
+ const PangoFontDescription *font_desc)
+{
+ g_return_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self));
+ g_return_if_fail (font_desc != NULL);
+
+ if (self->font_desc == font_desc ||
+ (self->font_desc && font_desc &&
+ pango_font_description_equal (self->font_desc, font_desc)))
+ return;
+
+ if (self->font_desc)
+ pango_font_description_free (self->font_desc);
+
+ self->font_desc = pango_font_description_copy (font_desc);
+
+ update_font_data (self);
+ update_font_info (self);
+ apply_use_font (self);
+
+ g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_FONT_DESC]);
+}
+
+/**
+ * gtk_font_dialog_button_get_font_desc:
+ * @self: a `GtkFontDialogButton`
+ *
+ * Returns the font of the button.
+ *
+ * This function is what should be used to obtain
+ * the font that was choosen by the user. To get
+ * informed about changes, listen to "notify::font-desc".
+ *
+ * Returns: (transfer none) (nullable): the font
+ *
+ * Since: 4.10
+ */
+PangoFontDescription *
+gtk_font_dialog_button_get_font_desc (GtkFontDialogButton *self)
+{
+ g_return_val_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self), NULL);
+
+ return self->font_desc;
+}
+
+/**
+ * gtk_font_dialog_button_set_font_features:
+ * @self: a `GtkFontDialogButton`
+ * @font_features: (nullable): the font features
+ *
+ * Sets the font features of the button.
+ *
+ * Since: 4.10
+ */
+void
+gtk_font_dialog_button_set_font_features (GtkFontDialogButton *self,
+ const char *font_features)
+{
+ char *new_features;
+
+ g_return_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self));
+
+ if (g_strcmp0 (self->font_features, font_features) == 0)
+ return;
+
+ new_features = g_strdup (font_features);
+ g_free (self->font_features);
+ self->font_features = new_features;
+
+ apply_use_font (self);
+
+ g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_FONT_FEATURES]);
+}
+
+/**
+ * gtk_font_dialog_button_get_font_features:
+ * @self: a `GtkFontDialogButton`
+ *
+ * Returns the font features of the button.
+ *
+ * This function is what should be used to obtain the font features
+ * that were choosen by the user. To get informed about changes, listen
+ * to "notify::font-features".
+ *
+ * Note that the button will only let users choose font features
+ * if [property@Gtk.FontDialogButton:level] is set to
+ * `GTK_FONT_LEVEL_FEATURES`.
+ *
+ * Returns: (transfer none) (nullable): the font features
+ *
+ * Since: 4.10
+ */
+const char *
+gtk_font_dialog_button_get_font_features (GtkFontDialogButton *self)
+{
+ g_return_val_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self), NULL);
+
+ return self->font_features;
+}
+
+/**
+ * gtk_font_dialog_button_set_language:
+ * @self: a `GtkFontDialogButton`
+ * @language: (nullable): the new language
+ *
+ * Sets the language to use for font features.
+ *
+ * Since: 4.10
+ */
+void
+gtk_font_dialog_button_set_language (GtkFontDialogButton *self,
+ PangoLanguage *language)
+{
+ g_return_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self));
+
+ if (self->language == language)
+ return;
+
+ self->language = language;
+
+ apply_use_font (self);
+
+ g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_LANGUAGE]);
+}
+
+/**
+ * gtk_font_dialog_button_get_language:
+ * @self: a `GtkFontDialogButton`
+ *
+ * Returns the language that is used for font features.
+ *
+ * Returns: (nullable): the language
+ *
+ * Since: 4.10
+ */
+PangoLanguage *
+gtk_font_dialog_button_get_language (GtkFontDialogButton *self)
+{
+ g_return_val_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self), NULL);
+
+ return self->language;
+}
+
+/* }}} */
+
+/* vim:set foldmethod=marker expandtab: */
+/**
+ * gtk_font_dialog_button_set_use_font:
+ * @self: a `GtkFontDialogButton`
+ * @use_font: If `TRUE`, font name will be written using
+ * the chosen font
+ *
+ * If @use_font is `TRUE`, the font name will be written
+ * using the selected font.
+ *
+ * Since: 4.10
+ */
+void
+gtk_font_dialog_button_set_use_font (GtkFontDialogButton *self,
+ gboolean use_font)
+{
+ g_return_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self));
+
+ if (self->use_font == use_font)
+ return;
+
+ self->use_font = use_font;
+
+ apply_use_font (self);
+
+ g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_USE_FONT]);
+}
+
+/**
+ * gtk_font_dialog_button_get_use_font:
+ * @self: a `GtkFontDialogButton`
+ *
+ * Returns whether the selected font is used in the label.
+ *
+ * Returns: whether the selected font is used in the label
+ *
+ * Since: 4.10
+ */
+gboolean
+gtk_font_dialog_button_get_use_font (GtkFontDialogButton *self)
+{
+ g_return_val_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self), FALSE);
+
+ return self->use_font;
+}
+
+/**
+ * gtk_font_dialog_button_set_use_size:
+ * @self: a `GtkFontDialogButton`
+ * @use_size: If `TRUE`, font name will be written using
+ * the chosen font size
+ *
+ * If @use_size is `TRUE`, the font name will be written
+ * using the selected font size.
+ *
+ * Since: 4.10
+ */
+void
+gtk_font_dialog_button_set_use_size (GtkFontDialogButton *self,
+ gboolean use_size)
+{
+ g_return_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self));
+
+ if (self->use_size == use_size)
+ return;
+
+ self->use_size = use_size;
+
+ apply_use_font (self);
+
+ g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_USE_SIZE]);
+}
+
+/**
+ * gtk_font_dialog_button_get_use_size:
+ * @self: a `GtkFontDialogButton`
+ *
+ * Returns whether the selected font size is used in the label.
+ *
+ * Returns: whether the selected font size is used in the label
+ *
+ * Since: 4.10
+ */
+gboolean
+gtk_font_dialog_button_get_use_size (GtkFontDialogButton *self)
+{
+ g_return_val_if_fail (GTK_IS_FONT_DIALOG_BUTTON (self), FALSE);
+
+ return self->use_size;
+}
+
+/* }}} */
+
+/* vim:set foldmethod=marker expandtab: */