1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * Massively updated for Pango by Owen Taylor, May 2000
5 * GtkFontSelection widget for Gtk+, by Damon Chaplin, May 1998.
6 * Based on the GnomeFontSelector widget, by Elliot Lee, but major changes.
7 * The GnomeFontSelector was derived from app/text_tool.c in the GIMP.
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the
21 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22 * Boston, MA 02111-1307, USA.
26 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
27 * file for a list of people on the GTK+ Team. See the ChangeLog
28 * files for a list of changes. These files are distributed with
29 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
35 #include <glib/gprintf.h>
40 #include "gtkfontsel.h"
41 #include "gtkbutton.h"
42 #include "gtkcellrenderertext.h"
48 #include "gtkliststore.h"
52 #include "gtktreeselection.h"
53 #include "gtktreeview.h"
55 #include "gtkscrolledwindow.h"
57 #include "gtkaccessible.h"
58 #include "gtkbuildable.h"
59 #include "gtkprivate.h"
60 #include "gtkalignment.h"
63 #include "gtkspinbutton.h"
64 #include "gtkwidget.h"
68 * @Short_description: A widget for selecting fonts
69 * @Title: GtkFontSelection
70 * @See_also: #GtkFontSelectionDialog
72 * The #GtkFontSelection widget lists the available fonts, styles and sizes,
73 * allowing the user to select a font.
74 * It is used in the #GtkFontSelectionDialog widget to provide a dialog box for
77 * To set the font which is initially selected, use
78 * gtk_font_selection_set_font_name().
80 * To get the selected font use gtk_font_selection_get_font_name().
82 * To change the text which is shown in the preview area, use
83 * gtk_font_selection_set_preview_text().
87 struct _GtkFontSelectionPrivate
89 GtkWidget *search_entry;
90 GtkWidget *family_face_list;
91 GtkWidget *size_slider;
100 PangoFontFamily *family;
102 gboolean ignore_slider;
104 /*FIXME: Remove these widgets after deprecation removal */
105 GtkWidget *size_list;
106 GtkWidget *font_list;
107 GtkWidget *face_list;
109 GtkListStore *_size_model;
110 GtkListStore *_font_model;
111 GtkListStore *_face_model;
115 struct _GtkFontSelectionDialogPrivate
119 GtkWidget *ok_button;
120 GtkWidget *apply_button;
121 GtkWidget *cancel_button;
125 #define DEFAULT_FONT_NAME "Sans 10"
126 #define MAX_FONT_SIZE 999
128 /* This is the initial fixed height and the top padding of the preview entry */
129 #define PREVIEW_HEIGHT 72
130 #define PREVIEW_TOP_PADDING 6
132 /* Widget default geometry */
133 #define FONTSEL_WIDTH 540
134 #define FONTSEL_HEIGHT 408
136 /* These are the sizes of the font, style & size lists. */
137 #define FONT_LIST_HEIGHT 136
138 #define FONT_LIST_WIDTH 190
139 #define FONT_STYLE_LIST_WIDTH 170
140 #define FONT_SIZE_LIST_WIDTH 60
142 #define ROW_FORMAT_STRING "<span weight=\"bold\" size=\"small\" foreground=\"%s\">%s</span>\n<span size=\"x-large\" font_desc=\"%s\">%s</span>"
144 /* These are what we use as the standard font sizes, for the size list.
146 #define FONT_SIZES_LENGTH 14
147 static const gint font_sizes[] = {
148 6, 8, 9, 10, 11, 12, 13, 14, 16, 20, 24, 36, 48, 72
162 PREVIEW_TITLE_COLUMN,
163 /*FIXME: Remove two strings after deprecation removal */
168 static void gtk_font_selection_set_property (GObject *object,
172 static void gtk_font_selection_get_property (GObject *object,
176 static void gtk_font_selection_finalize (GObject *object);
179 static void gtk_font_selection_screen_changed (GtkWidget *widget,
180 GdkScreen *previous_screen);
181 static void gtk_font_selection_style_updated (GtkWidget *widget);
184 static void gtk_font_selection_ref_family (GtkFontSelection *fontsel,
185 PangoFontFamily *family);
186 static void gtk_font_selection_ref_face (GtkFontSelection *fontsel,
187 PangoFontFace *face);
189 static void gtk_font_selection_bootstrap_fontlist (GtkFontSelection *fontsel);
191 G_DEFINE_TYPE (GtkFontSelection, gtk_font_selection, GTK_TYPE_VBOX)
194 gtk_font_selection_class_init (GtkFontSelectionClass *klass)
196 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
199 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
200 widget_class->screen_changed = gtk_font_selection_screen_changed;
201 widget_class->style_updated = gtk_font_selection_style_updated;
204 gobject_class->finalize = gtk_font_selection_finalize;
205 gobject_class->set_property = gtk_font_selection_set_property;
206 gobject_class->get_property = gtk_font_selection_get_property;
208 g_object_class_install_property (gobject_class,
210 g_param_spec_string ("font-name",
212 P_("The string that represents this font"),
214 GTK_PARAM_READWRITE));
215 g_object_class_install_property (gobject_class,
217 g_param_spec_string ("preview-text",
219 P_("The text to display in order to demonstrate the selected font"),
220 pango_language_get_sample_string (NULL),
221 GTK_PARAM_READWRITE));
223 g_type_class_add_private (klass, sizeof (GtkFontSelectionPrivate));
227 gtk_font_selection_set_property (GObject *object,
232 GtkFontSelection *fontsel;
234 fontsel = GTK_FONT_SELECTION (object);
239 gtk_font_selection_set_font_name (fontsel, g_value_get_string (value));
241 case PROP_PREVIEW_TEXT:
242 gtk_font_selection_set_preview_text (fontsel, g_value_get_string (value));
245 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
251 gtk_font_selection_get_property (GObject *object,
256 GtkFontSelection *fontsel;
258 fontsel = GTK_FONT_SELECTION (object);
263 g_value_take_string (value, gtk_font_selection_get_font_name (fontsel));
265 case PROP_PREVIEW_TEXT:
266 g_value_set_string (value, gtk_font_selection_get_preview_text (fontsel));
269 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
275 refilter_and_focus (GtkFontSelectionPrivate *priv)
278 GtkTreeView *treeview = GTK_TREE_VIEW (priv->family_face_list);
279 GtkTreePath *path = gtk_tree_path_new ();
281 gtk_tree_model_filter_refilter (GTK_TREE_MODEL_FILTER (priv->filter));
286 gtk_tree_view_get_cursor (treeview, &path, NULL);
288 if (!gtk_tree_model_get_iter (GTK_TREE_MODEL (priv->filter), &iter, path))
290 gtk_tree_path_free (path);
294 gtk_tree_view_scroll_to_cell (treeview, path, NULL, FALSE, 0.0, 0.0);
295 gtk_tree_path_free (path);
299 deleted_text_cb (GtkEntryBuffer *buffer,
304 GtkFontSelectionPrivate *priv = (GtkFontSelectionPrivate*)user_data;
305 GtkWidget *entry = priv->search_entry;
307 if (gtk_entry_buffer_get_length (buffer) == 0)
309 gtk_entry_set_icon_from_stock (GTK_ENTRY (entry),
310 GTK_ENTRY_ICON_SECONDARY,
314 gtk_tree_model_filter_refilter (GTK_TREE_MODEL_FILTER (priv->filter));
318 inserted_text_cb (GtkEntryBuffer *buffer,
324 GtkFontSelectionPrivate *priv = (GtkFontSelectionPrivate*)user_data;
325 GtkWidget *entry = priv->search_entry;
327 if (g_strcmp0 (gtk_entry_get_icon_stock (GTK_ENTRY (entry), GTK_ENTRY_ICON_SECONDARY),
329 gtk_entry_set_icon_from_stock (GTK_ENTRY (entry),
330 GTK_ENTRY_ICON_SECONDARY,
334 gtk_tree_model_filter_refilter (GTK_TREE_MODEL_FILTER (priv->filter));
338 icon_press_cb (GtkEntry *entry,
339 GtkEntryIconPosition pos,
343 gtk_entry_buffer_delete_text (gtk_entry_get_buffer (entry), 0, -1);
347 slider_change_cb (GtkAdjustment *adjustment, gpointer data)
349 GtkFontSelectionPrivate *priv = (GtkFontSelectionPrivate*)data;
351 /* If we set the silder value manually, we ignore this callback */
352 if (priv->ignore_slider)
354 priv->ignore_slider = FALSE;
358 gtk_adjustment_set_value (gtk_spin_button_get_adjustment( GTK_SPIN_BUTTON(priv->size_spin)),
359 gtk_adjustment_get_value (adjustment));
363 spin_change_cb (GtkAdjustment *adjustment, gpointer data)
365 PangoFontDescription *desc;
366 GtkFontSelectionPrivate *priv = (GtkFontSelectionPrivate*)data;
368 gdouble size = gtk_adjustment_get_value (adjustment);
370 GtkAdjustment *slider_adj = gtk_range_get_adjustment (GTK_RANGE (priv->size_slider));
372 /* We ignore the slider value change callback for both of this set_value call */
373 priv->ignore_slider = TRUE;
374 if (size < gtk_adjustment_get_lower (slider_adj))
375 gtk_adjustment_set_value (slider_adj, gtk_adjustment_get_lower (slider_adj));
376 else if (size > gtk_adjustment_get_upper (slider_adj))
377 gtk_adjustment_set_value (slider_adj, gtk_adjustment_get_upper (slider_adj));
379 gtk_adjustment_set_value (slider_adj, size);
381 priv->size = ((gint)gtk_adjustment_get_value (adjustment)) * PANGO_SCALE;
383 desc = pango_context_get_font_description (gtk_widget_get_pango_context (priv->preview));
384 pango_font_description_set_size (desc, priv->size);
385 gtk_widget_override_font (priv->preview, desc);
387 gtk_widget_queue_draw (priv->preview);
391 set_range_marks (GtkFontSelectionPrivate *priv,
392 GtkWidget* size_slider,
402 sizes = (gint*)font_sizes;
403 length = FONT_SIZES_LENGTH;
406 gtk_scale_clear_marks (GTK_SCALE (size_slider));
408 adj = gtk_range_get_adjustment(GTK_RANGE (size_slider));
410 gtk_adjustment_set_lower (adj, (gdouble) sizes[0]);
411 gtk_adjustment_set_upper (adj, (gdouble) sizes[length-1]);
413 value = gtk_adjustment_get_value (adj);
414 if (value > (gdouble) sizes[length-1])
416 gtk_adjustment_set_value (adj, (gdouble) sizes[length-1]);
417 priv->ignore_slider = TRUE;
419 else if (value < (gdouble) sizes[0])
421 gtk_adjustment_set_value (adj, (gdouble) sizes[0]);
422 priv->ignore_slider = TRUE;
425 for (i=0; i<length; i++)
426 gtk_scale_add_mark (GTK_SCALE (size_slider),
428 GTK_POS_BOTTOM, NULL);
433 cursor_changed_cb (GtkTreeView *treeview, gpointer data)
435 PangoFontFamily *family;
437 PangoFontDescription *desc;
443 GtkTreePath *path = gtk_tree_path_new ();
445 GtkFontSelection *fontsel = (GtkFontSelection*)data;
447 gtk_tree_view_get_cursor (treeview, &path, NULL);
452 if (!gtk_tree_model_get_iter (GTK_TREE_MODEL (fontsel->priv->filter), &iter, path))
454 gtk_tree_path_free (path);
459 gtk_tree_model_get (GTK_TREE_MODEL (fontsel->priv->filter), &iter,
461 FAMILY_COLUMN, &family,
464 gtk_tree_view_scroll_to_cell (treeview, path, NULL, FALSE, 0.0, 0.0);
466 gtk_tree_path_free (path);
469 if (!face || !family)
471 g_object_unref (face);
472 g_object_unref (family);
476 desc = pango_font_face_describe (face);
477 pango_font_description_set_size (desc, fontsel->priv->size);
478 gtk_widget_override_font (fontsel->priv->preview, desc);
480 pango_font_face_list_sizes (face, &sizes, &n_sizes);
481 /* It seems not many fonts actually have a sane set of sizes */
482 for (i=0; i<n_sizes; i++)
483 sizes[i] = sizes[i] / PANGO_SCALE;
485 set_range_marks (fontsel->priv, fontsel->priv->size_slider, sizes, n_sizes);
487 gtk_font_selection_ref_family (fontsel, family);
488 gtk_font_selection_ref_face (fontsel, face);
491 g_object_unref ((gpointer)face);
492 pango_font_description_free(desc);
496 zoom_preview_cb (GtkWidget *scrolled_window, GdkEventScroll *event, gpointer data)
498 GtkFontSelectionPrivate *priv = (GtkFontSelectionPrivate*)data;
500 GtkAdjustment *adj = gtk_spin_button_get_adjustment (GTK_SPIN_BUTTON (priv->size_spin));
502 if (event->direction == GDK_SCROLL_UP || event->direction == GDK_SCROLL_RIGHT)
503 gtk_adjustment_set_value (adj,
504 gtk_adjustment_get_value (adj) +
505 gtk_adjustment_get_step_increment (adj));
506 else if (event->direction == GDK_SCROLL_DOWN || event->direction == GDK_SCROLL_LEFT)
507 gtk_adjustment_set_value (adj,
508 gtk_adjustment_get_value (adj) -
509 gtk_adjustment_get_step_increment (adj));
514 gtk_font_selection_init (GtkFontSelection *fontsel)
516 GtkFontSelectionPrivate *priv;
517 PangoFontDescription *font_desc;
518 GtkWidget *scrolled_win;
519 GtkWidget *alignment;
520 GtkWidget *preview_and_size;
521 GtkWidget *size_controls;
523 fontsel->priv = G_TYPE_INSTANCE_GET_PRIVATE (fontsel,
524 GTK_TYPE_FONT_SELECTION,
525 GtkFontSelectionPrivate);
527 priv = fontsel->priv;
528 priv->size_list = NULL;
529 priv->font_list = NULL;
530 priv->face_list = NULL;
532 priv->_size_model = NULL;
533 priv->_font_model = NULL;
534 priv->_face_model = NULL;
536 gtk_widget_push_composite_child ();
538 /* Creating fundamental widgets for the private struct */
539 priv->search_entry = gtk_entry_new ();
540 priv->family_face_list = gtk_tree_view_new ();
541 priv->preview = gtk_entry_new ();
542 priv->size_slider = gtk_scale_new_with_range (GTK_ORIENTATION_HORIZONTAL,
543 (gdouble) font_sizes[0],
544 (gdouble) font_sizes[FONT_SIZES_LENGTH - 1],
547 priv->size_spin = gtk_spin_button_new_with_range (0.0, (gdouble)(G_MAXINT / PANGO_SCALE), 1.0);
549 /** Bootstrapping widget layout **/
550 gtk_box_set_spacing (GTK_BOX (fontsel), 6);
551 gtk_box_pack_start (GTK_BOX (fontsel), priv->search_entry, FALSE, TRUE, 0);
553 /* Main font family/face view */
554 scrolled_win = gtk_scrolled_window_new (NULL, NULL);
555 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_win),
556 GTK_POLICY_NEVER, GTK_POLICY_AUTOMATIC);
557 gtk_scrolled_window_set_shadow_type (GTK_SCROLLED_WINDOW (scrolled_win),
558 GTK_SHADOW_ETCHED_IN);
559 gtk_container_add (GTK_CONTAINER (scrolled_win), priv->family_face_list);
561 /* Alignment for the preview and size controls */
562 /* alignment = gtk_alignment_new (0.5, 0.5, 1.0, 1.0);
563 gtk_alignment_set_padding (GTK_ALIGNMENT (alignment),
564 PREVIEW_TOP_PADDING, 0, 0, 0);*/
565 gtk_box_pack_start (GTK_BOX (fontsel), scrolled_win, TRUE, TRUE, 0);
567 preview_and_size = gtk_vbox_new (TRUE, 0);
568 gtk_box_set_homogeneous (GTK_BOX (preview_and_size), FALSE);
569 gtk_box_set_spacing (GTK_BOX (preview_and_size), 6);
571 /* The preview entry needs a scrolled window to make sure we have a */
572 scrolled_win = gtk_scrolled_window_new (NULL, NULL);
573 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_win),
574 GTK_POLICY_NEVER, GTK_POLICY_AUTOMATIC);
575 gtk_scrolled_window_set_shadow_type (GTK_SCROLLED_WINDOW (scrolled_win),
576 GTK_SHADOW_ETCHED_IN);
577 gtk_scrolled_window_add_with_viewport (GTK_SCROLLED_WINDOW (scrolled_win),
579 gtk_box_pack_start (GTK_BOX (preview_and_size), scrolled_win, FALSE, FALSE, 0);
581 /* Setting the size requests for various widgets */
582 gtk_widget_set_size_request (GTK_WIDGET (fontsel), FONTSEL_WIDTH, FONTSEL_HEIGHT);
583 gtk_widget_set_size_request (scrolled_win, -1, PREVIEW_HEIGHT);
584 gtk_widget_set_size_request (priv->preview, -1, PREVIEW_HEIGHT - 6);
586 /* Unset the frame on the preview entry */
587 gtk_entry_set_has_frame (GTK_ENTRY (priv->preview), FALSE);
589 /* Packing the slider and the spin in a hbox */
590 size_controls = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 0);
591 gtk_scale_set_draw_value (GTK_SCALE (priv->size_slider), FALSE);
592 gtk_box_set_spacing (GTK_BOX (size_controls), 6);
593 gtk_box_pack_start (GTK_BOX (size_controls), priv->size_slider, TRUE, TRUE, 0);
594 gtk_box_pack_start (GTK_BOX (size_controls), priv->size_spin, FALSE, TRUE, 0);
596 gtk_widget_set_valign (priv->size_spin, GTK_ALIGN_START);
598 gtk_box_pack_start (GTK_BOX (preview_and_size), size_controls, FALSE, FALSE, 0);
599 // gtk_container_add (GTK_CONTAINER (alignment), preview_and_size);
601 gtk_box_pack_start (GTK_BOX (fontsel), GTK_WIDGET(preview_and_size), FALSE, TRUE, 0);
603 /* Getting the default size */
604 font_desc = pango_context_get_font_description (gtk_widget_get_pango_context (GTK_WIDGET (fontsel)));
605 priv->size = pango_font_description_get_size (font_desc);
609 gtk_adjustment_set_value (gtk_range_get_adjustment (GTK_RANGE (priv->size_slider)),
610 (gdouble)(priv->size / PANGO_SCALE));
611 gtk_adjustment_set_value (gtk_spin_button_get_adjustment (GTK_SPIN_BUTTON (priv->size_spin)),
612 (gdouble)(priv->size / PANGO_SCALE));
614 gtk_widget_show_all (GTK_WIDGET (fontsel));
615 gtk_widget_hide (GTK_WIDGET (fontsel));
617 /* Treeview column and model bootstrapping */
618 gtk_font_selection_bootstrap_fontlist (fontsel);
620 /* Set default preview text */
621 gtk_entry_set_text (GTK_ENTRY (priv->preview),
622 pango_language_get_sample_string (NULL));
624 /* Set search icon and place holder text */
625 gtk_entry_set_icon_from_stock (GTK_ENTRY (priv->search_entry),
626 GTK_ENTRY_ICON_SECONDARY,
628 gtk_entry_set_placeholder_text (GTK_ENTRY (priv->search_entry), _("Search font name"));
630 /** Callback connections **/
631 /* Connect to callback for the live search text entry */
632 g_signal_connect (G_OBJECT (gtk_entry_get_buffer (GTK_ENTRY (priv->search_entry))),
633 "deleted-text", G_CALLBACK (deleted_text_cb), priv);
634 g_signal_connect (G_OBJECT (gtk_entry_get_buffer (GTK_ENTRY (priv->search_entry))),
635 "inserted-text", G_CALLBACK (inserted_text_cb), priv);
636 g_signal_connect (G_OBJECT (priv->search_entry),
637 "icon-press", G_CALLBACK (icon_press_cb), priv);
639 /* Size controls callbacks */
640 g_signal_connect (G_OBJECT (gtk_range_get_adjustment (GTK_RANGE (priv->size_slider))),
641 "value-changed", G_CALLBACK (slider_change_cb), priv);
642 g_signal_connect (G_OBJECT (gtk_spin_button_get_adjustment (GTK_SPIN_BUTTON (priv->size_spin))),
643 "value-changed", G_CALLBACK (spin_change_cb), priv);
644 priv->ignore_slider = FALSE;
646 /* Font selection callback */
647 g_signal_connect (G_OBJECT (priv->family_face_list), "cursor-changed",
648 G_CALLBACK (cursor_changed_cb), fontsel);
650 /* Zoom on preview scroll*/
651 g_signal_connect (G_OBJECT (scrolled_win), "scroll-event",
652 G_CALLBACK (zoom_preview_cb), priv);
654 g_signal_connect (G_OBJECT (priv->size_slider), "scroll-event",
655 G_CALLBACK (zoom_preview_cb), priv);
657 set_range_marks (priv, priv->size_slider, (gint*)font_sizes, FONT_SIZES_LENGTH);
659 /* Set default focus */
660 gtk_widget_pop_composite_child();
664 * gtk_font_selection_new:
666 * Creates a new #GtkFontSelection.
668 * Return value: a new #GtkFontSelection
671 gtk_font_selection_new (void)
673 GtkFontSelection *fontsel;
675 fontsel = g_object_new (GTK_TYPE_FONT_SELECTION, NULL);
677 return GTK_WIDGET (fontsel);
681 cmp_families (const void *a, const void *b)
683 const char *a_name = pango_font_family_get_name (*(PangoFontFamily **)a);
684 const char *b_name = pango_font_family_get_name (*(PangoFontFamily **)b);
686 return g_utf8_collate (a_name, b_name);
690 populate_list (GtkTreeView* treeview, GtkListStore* model)
692 GtkStyleContext *style_context;
697 GtkTreeIter match_row;
701 PangoFontFamily **families;
703 GString *tmp = g_string_new (NULL);
704 GString *family_and_face = g_string_new (NULL);
706 pango_context_list_families (gtk_widget_get_pango_context (GTK_WIDGET (treeview)),
710 qsort (families, n_families, sizeof (PangoFontFamily *), cmp_families);
712 gtk_list_store_clear (model);
714 /* Get row header font color */
715 style_context = gtk_widget_get_style_context (GTK_WIDGET (treeview));
716 gtk_style_context_get_color (style_context,
717 GTK_STATE_FLAG_NORMAL |GTK_STATE_FLAG_INSENSITIVE,
720 p_color.red = (guint16)((gdouble)G_MAXUINT16 * g_color.red);
721 p_color.green = (guint16)((gdouble)G_MAXUINT16 * g_color.green);
722 p_color.blue = (guint16)((gdouble)G_MAXUINT16 * g_color.blue);
723 color_string = pango_color_to_string (&p_color);
725 /* Iterate over families and faces */
726 for (i=0; i<n_families; i++)
729 PangoFontFace **faces;
732 const gchar *fam_name = pango_font_family_get_name (families[i]);
734 pango_font_family_list_faces (families[i], &faces, &n_faces);
736 for (j=0; j<n_faces; j++)
738 PangoFontDescription *pango_desc = pango_font_face_describe (faces[j]);
739 const gchar *face_name = pango_font_face_get_face_name (faces[j]);
740 gchar *font_desc = pango_font_description_to_string (pango_desc);
742 /* foreground_color, family_name, face_name, desc, sample string */
743 g_string_printf (family_and_face, "%s %s",
747 g_string_printf (tmp, ROW_FORMAT_STRING,
749 family_and_face->str,
751 pango_language_get_sample_string (NULL));
753 gtk_list_store_append (model, &iter);
754 gtk_list_store_set (model, &iter,
755 FAMILY_COLUMN, families[i],
756 FACE_COLUMN, faces[j],
757 PREVIEW_TITLE_COLUMN, family_and_face->str,
758 PREVIEW_TEXT_COLUMN, tmp->str,
759 /** FIXME: FAMILY_NAME_COLUMN and FACE_NAME_COLUMN
760 are needed only until we remove the deprecated
762 FAMILY_NAME_COLUMN, fam_name,
763 FACE_NAME_COLUMN, face_name,
766 if ((i == 0 && j == 0) ||
767 (!g_ascii_strcasecmp (face_name, "sans") && j == 0))
772 pango_font_description_free(pango_desc);
779 path = gtk_tree_model_get_path (GTK_TREE_MODEL (model), &match_row);
783 gtk_tree_view_set_cursor (treeview, path, NULL, FALSE);
784 gtk_tree_path_free(path);
788 g_string_free (family_and_face, TRUE);
789 g_string_free (tmp, TRUE);
790 g_free (color_string);
795 visible_func (GtkTreeModel *model, GtkTreeIter *iter, gpointer data)
797 gboolean result = FALSE;
798 GtkFontSelectionPrivate *priv = (GtkFontSelectionPrivate*) data;
800 const gchar *search_text = (const gchar*)gtk_entry_get_text (GTK_ENTRY (priv->search_entry));
802 gchar *font_name_casefold;
803 gchar *search_text_casefold;
805 gtk_tree_model_get (model, iter,
806 PREVIEW_TITLE_COLUMN, &font_name,
809 /* Covering some corner cases to speed up the result */
810 if (font_name == NULL ||
811 strlen (search_text) > strlen (font_name))
816 if (strlen (search_text) == 0)
822 font_name_casefold = g_utf8_casefold (font_name, -1);
823 search_text_casefold = g_utf8_casefold (search_text, -1);
825 if (g_strrstr (font_name_casefold, search_text_casefold))
828 g_free (search_text_casefold);
829 g_free (font_name_casefold);
835 gtk_font_selection_bootstrap_fontlist (GtkFontSelection* fontsel)
837 GtkTreeView *treeview = GTK_TREE_VIEW (fontsel->priv->family_face_list);
838 GtkCellRenderer *cell;
839 GtkTreeViewColumn *col;
841 fontsel->priv->model = gtk_list_store_new (6,
842 PANGO_TYPE_FONT_FAMILY,
843 PANGO_TYPE_FONT_FACE,
846 /*FIXME: Remove two strings after deprecation removal */
850 fontsel->priv->filter = gtk_tree_model_filter_new (GTK_TREE_MODEL (fontsel->priv->model),
852 g_object_unref (fontsel->priv->model);
854 gtk_tree_model_filter_set_visible_func (GTK_TREE_MODEL_FILTER (fontsel->priv->filter),
856 (gpointer)fontsel->priv,
859 gtk_tree_view_set_model (treeview, GTK_TREE_MODEL (fontsel->priv->filter));
860 g_object_unref (fontsel->priv->filter);
862 gtk_tree_view_set_rules_hint (treeview, TRUE);
863 gtk_tree_view_set_headers_visible (treeview, FALSE);
865 cell = gtk_cell_renderer_text_new ();
866 col = gtk_tree_view_column_new_with_attributes ("Family",
868 "markup", PREVIEW_TEXT_COLUMN,
872 g_object_set (cell, "ellipsize", PANGO_ELLIPSIZE_END, NULL);
874 gtk_tree_view_append_column (treeview, col);
876 populate_list (treeview, fontsel->priv->model);
881 gtk_font_selection_finalize (GObject *object)
883 GtkFontSelection *fontsel = GTK_FONT_SELECTION (object);
885 gtk_font_selection_ref_family (fontsel, NULL);
886 gtk_font_selection_ref_face (fontsel, NULL);
888 G_OBJECT_CLASS (gtk_font_selection_parent_class)->finalize (object);
893 gtk_font_selection_screen_changed (GtkWidget *widget,
894 GdkScreen *previous_screen)
900 gtk_font_selection_style_updated (GtkWidget *widget)
902 /*GTK_WIDGET_CLASS (gtk_font_selection_parent_class)->style_updated (widget);*/
908 gtk_font_selection_ref_family (GtkFontSelection *fontsel,
909 PangoFontFamily *family)
911 GtkFontSelectionPrivate *priv = fontsel->priv;
914 family = g_object_ref (family);
916 g_object_unref (priv->family);
917 priv->family = family;
921 gtk_font_selection_ref_face (GtkFontSelection *fontsel,
924 GtkFontSelectionPrivate *priv = fontsel->priv;
927 face = g_object_ref (face);
929 g_object_unref (priv->face);
933 /* These functions populate the deprecated widgets to maintain API compatibility */
935 populate_font_model (GtkFontSelection *fontsel)
937 GtkFontSelectionPrivate *priv = fontsel->priv;
941 update_font_model_selection (GtkFontSelection *fontsel)
943 GtkFontSelectionPrivate *priv = fontsel->priv;
947 update_face_model (GtkFontSelection *fontsel)
949 GtkFontSelectionPrivate *priv = fontsel->priv;
953 update_size_model (GtkFontSelection *fontsel)
955 GtkFontSelectionPrivate *priv = fontsel->priv;
959 initialize_deprecated_widgets (GtkFontSelection *fontsel)
961 GtkFontSelectionPrivate *priv = fontsel->priv;
963 priv->_size_model = gtk_list_store_new (2, G_TYPE_INT, G_TYPE_STRING);
964 priv->_font_model = gtk_list_store_new (2, PANGO_TYPE_FONT_FAMILY, G_TYPE_STRING);
965 priv->_face_model = gtk_list_store_new (2, PANGO_TYPE_FONT_FACE, G_TYPE_STRING);
967 priv->size_list = gtk_tree_view_new_with_model (GTK_TREE_MODEL (priv->_size_model));
968 priv->font_list = gtk_tree_view_new_with_model (GTK_TREE_MODEL (priv->_font_model));
969 priv->face_list = gtk_tree_view_new_with_model (GTK_TREE_MODEL (priv->_size_model));
971 g_object_unref (priv->_size_model);
972 g_object_unref (priv->_font_model);
973 g_object_unref (priv->_face_model);
977 destroy_deprecated_widgets (GtkFontSelection *fontsel)
979 GtkFontSelectionPrivate *priv = fontsel->priv;
981 g_object_unref (priv->size_list);
982 g_object_unref (priv->font_list);
983 g_object_unref (priv->face_list);
986 /*****************************************************************************
987 * These functions are the main public interface for getting/setting the font.
988 *****************************************************************************/
991 * gtk_font_selection_get_family_list:
992 * @fontsel: a #GtkFontSelection
994 * This returns the #GtkTreeView that lists font families, for
995 * example, 'Sans', 'Serif', etc.
997 * Return value: (transfer none): A #GtkWidget that is part of @fontsel
1002 gtk_font_selection_get_family_list (GtkFontSelection *fontsel)
1004 GtkFontSelectionPrivate *priv = fontsel->priv;
1005 g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL);
1011 * gtk_font_selection_get_face_list:
1012 * @fontsel: a #GtkFontSelection
1014 * This returns the #GtkTreeView which lists all styles available for
1015 * the selected font. For example, 'Regular', 'Bold', etc.
1017 * Return value: (transfer none): A #GtkWidget that is part of @fontsel
1022 gtk_font_selection_get_face_list (GtkFontSelection *fontsel)
1024 GtkFontSelectionPrivate *priv = fontsel->priv;
1025 g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL);
1031 * gtk_font_selection_get_size_entry:
1032 * @fontsel: a #GtkFontSelection
1034 * This returns the #GtkEntry used to allow the user to edit the font
1035 * number manually instead of selecting it from the list of font sizes.
1037 * Return value: (transfer none): A #GtkWidget that is part of @fontsel
1042 gtk_font_selection_get_size_entry (GtkFontSelection *fontsel)
1044 GtkFontSelectionPrivate *priv = fontsel->priv;
1045 g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL);
1047 return priv->size_spin;
1051 * gtk_font_selection_get_size_list:
1052 * @fontsel: a #GtkFontSelection
1054 * This returns the #GtkTreeeView used to list font sizes.
1056 * Return value: (transfer none): A #GtkWidget that is part of @fontsel
1061 gtk_font_selection_get_size_list (GtkFontSelection *fontsel)
1063 GtkFontSelectionPrivate *priv = fontsel->priv;
1064 g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL);
1070 * gtk_font_selection_get_preview_entry:
1071 * @fontsel: a #GtkFontSelection
1073 * This returns the #GtkEntry used to display the font as a preview.
1075 * Return value: (transfer none): A #GtkWidget that is part of @fontsel
1080 gtk_font_selection_get_preview_entry (GtkFontSelection *fontsel)
1082 GtkFontSelectionPrivate *priv = fontsel->priv;
1083 g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL);
1085 return priv->preview;
1089 * gtk_font_selection_get_family:
1090 * @fontsel: a #GtkFontSelection
1092 * Gets the #PangoFontFamily representing the selected font family.
1094 * Return value: (transfer none): A #PangoFontFamily representing the
1095 * selected font family. Font families are a collection of font
1096 * faces. The returned object is owned by @fontsel and must not
1097 * be modified or freed.
1102 gtk_font_selection_get_family (GtkFontSelection *fontsel)
1104 g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL);
1110 * gtk_font_selection_get_face:
1111 * @fontsel: a #GtkFontSelection
1113 * Gets the #PangoFontFace representing the selected font group
1114 * details (i.e. family, slant, weight, width, etc).
1116 * Return value: (transfer none): A #PangoFontFace representing the
1117 * selected font group details. The returned object is owned by
1118 * @fontsel and must not be modified or freed.
1123 gtk_font_selection_get_face (GtkFontSelection *fontsel)
1125 g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL);
1131 * gtk_font_selection_get_size:
1132 * @fontsel: a #GtkFontSelection
1134 * The selected font size.
1136 * Return value: A n integer representing the selected font size,
1137 * or -1 if no font size is selected.
1142 gtk_font_selection_get_size (GtkFontSelection *fontsel)
1144 g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), -1);
1146 return fontsel->priv->size;
1150 * gtk_font_selection_get_font_name:
1151 * @fontsel: a #GtkFontSelection
1153 * Gets the currently-selected font name.
1155 * Note that this can be a different string than what you set with
1156 * gtk_font_selection_set_font_name(), as the font selection widget may
1157 * normalize font names and thus return a string with a different structure.
1158 * For example, "Helvetica Italic Bold 12" could be normalized to
1159 * "Helvetica Bold Italic 12". Use pango_font_description_equal()
1160 * if you want to compare two font descriptions.
1162 * Return value: (transfer full) (allow-none): A string with the name of the
1163 * current font, or %NULL if no font is selected. You must free this
1164 * string with g_free().
1167 gtk_font_selection_get_font_name (GtkFontSelection *fontsel)
1169 if (!fontsel->priv->family)
1172 return g_strdup (pango_font_family_get_name (fontsel->priv->family));
1175 /* This sets the current font, then selecting the appropriate list rows. */
1178 * gtk_font_selection_set_font_name:
1179 * @fontsel: a #GtkFontSelection
1180 * @fontname: a font name like "Helvetica 12" or "Times Bold 18"
1182 * Sets the currently-selected font.
1184 * Note that the @fontsel needs to know the screen in which it will appear
1185 * for this to work; this can be guaranteed by simply making sure that the
1186 * @fontsel is inserted in a toplevel window before you call this function.
1188 * Return value: %TRUE if the font could be set successfully; %FALSE if no
1189 * such font exists or if the @fontsel doesn't belong to a particular
1193 gtk_font_selection_set_font_name (GtkFontSelection *fontsel,
1194 const gchar *fontname)
1197 PangoFontFamily *family = NULL;
1198 PangoFontFace *face = NULL;
1199 PangoFontDescription *new_desc;
1202 g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), FALSE);
1208 * gtk_font_selection_get_preview_text:
1209 * @fontsel: a #GtkFontSelection
1211 * Gets the text displayed in the preview area.
1213 * Return value: the text displayed in the preview area.
1214 * This string is owned by the widget and should not be
1217 G_CONST_RETURN gchar*
1218 gtk_font_selection_get_preview_text (GtkFontSelection *fontsel)
1225 * gtk_font_selection_set_preview_text:
1226 * @fontsel: a #GtkFontSelection
1227 * @text: the text to display in the preview area
1229 * Sets the text displayed in the preview area.
1230 * The @text is used to show how the selected font looks.
1233 gtk_font_selection_set_preview_text (GtkFontSelection *fontsel,
1237 GtkFontSelectionPrivate *priv;
1239 g_return_if_fail (GTK_IS_FONT_SELECTION (fontsel));
1240 g_return_if_fail (text != NULL);
1242 priv = fontsel->priv;
1248 * SECTION:gtkfontseldlg
1249 * @Short_description: A dialog box for selecting fonts
1250 * @Title: GtkFontSelectionDialog
1251 * @See_also: #GtkFontSelection, #GtkDialog
1253 * The #GtkFontSelectionDialog widget is a dialog box for selecting a font.
1255 * To set the font which is initially selected, use
1256 * gtk_font_selection_dialog_set_font_name().
1258 * To get the selected font use gtk_font_selection_dialog_get_font_name().
1260 * To change the text which is shown in the preview area, use
1261 * gtk_font_selection_dialog_set_preview_text().
1263 * <refsect2 id="GtkFontSelectionDialog-BUILDER-UI">
1264 * <title>GtkFontSelectionDialog as GtkBuildable</title>
1265 * The GtkFontSelectionDialog implementation of the GtkBuildable interface
1266 * exposes the embedded #GtkFontSelection as internal child with the
1267 * name "font_selection". It also exposes the buttons with the names
1268 * "ok_button", "cancel_button" and "apply_button".
1272 static void gtk_font_selection_dialog_buildable_interface_init (GtkBuildableIface *iface);
1273 static GObject * gtk_font_selection_dialog_buildable_get_internal_child (GtkBuildable *buildable,
1274 GtkBuilder *builder,
1275 const gchar *childname);
1277 G_DEFINE_TYPE_WITH_CODE (GtkFontSelectionDialog, gtk_font_selection_dialog,
1279 G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
1280 gtk_font_selection_dialog_buildable_interface_init))
1282 static GtkBuildableIface *parent_buildable_iface;
1285 gtk_font_selection_dialog_class_init (GtkFontSelectionDialogClass *klass)
1287 g_type_class_add_private (klass, sizeof (GtkFontSelectionDialogPrivate));
1291 gtk_font_selection_dialog_init (GtkFontSelectionDialog *fontseldiag)
1293 GtkFontSelectionDialogPrivate *priv;
1294 GtkDialog *dialog = GTK_DIALOG (fontseldiag);
1295 GtkWidget *action_area, *content_area;
1297 fontseldiag->priv = G_TYPE_INSTANCE_GET_PRIVATE (fontseldiag,
1298 GTK_TYPE_FONT_SELECTION_DIALOG,
1299 GtkFontSelectionDialogPrivate);
1300 priv = fontseldiag->priv;
1302 content_area = gtk_dialog_get_content_area (dialog);
1303 action_area = gtk_dialog_get_action_area (dialog);
1305 gtk_container_set_border_width (GTK_CONTAINER (dialog), 5);
1306 gtk_box_set_spacing (GTK_BOX (content_area), 2); /* 2 * 5 + 2 = 12 */
1307 gtk_container_set_border_width (GTK_CONTAINER (action_area), 5);
1308 gtk_box_set_spacing (GTK_BOX (action_area), 6);
1310 gtk_widget_push_composite_child ();
1312 gtk_window_set_resizable (GTK_WINDOW (fontseldiag), TRUE);
1314 /* Create the content area */
1315 priv->fontsel = gtk_font_selection_new ();
1316 gtk_container_set_border_width (GTK_CONTAINER (priv->fontsel), 5);
1317 gtk_widget_show (priv->fontsel);
1318 gtk_box_pack_start (GTK_BOX (content_area),
1319 priv->fontsel, TRUE, TRUE, 0);
1321 /* Create the action area */
1322 priv->cancel_button = gtk_dialog_add_button (dialog,
1324 GTK_RESPONSE_CANCEL);
1326 priv->apply_button = gtk_dialog_add_button (dialog,
1328 GTK_RESPONSE_APPLY);
1329 gtk_widget_hide (priv->apply_button);
1331 priv->ok_button = gtk_dialog_add_button (dialog,
1334 gtk_widget_grab_default (priv->ok_button);
1336 gtk_dialog_set_alternative_button_order (GTK_DIALOG (fontseldiag),
1339 GTK_RESPONSE_CANCEL,
1342 gtk_window_set_title (GTK_WINDOW (fontseldiag),
1343 _("Font Selection"));
1345 gtk_widget_pop_composite_child ();
1349 * gtk_font_selection_dialog_new:
1350 * @title: the title of the dialog window
1352 * Creates a new #GtkFontSelectionDialog.
1354 * Return value: a new #GtkFontSelectionDialog
1357 gtk_font_selection_dialog_new (const gchar *title)
1359 GtkFontSelectionDialog *fontseldiag;
1361 fontseldiag = g_object_new (GTK_TYPE_FONT_SELECTION_DIALOG, NULL);
1364 gtk_window_set_title (GTK_WINDOW (fontseldiag), title);
1366 return GTK_WIDGET (fontseldiag);
1370 * gtk_font_selection_dialog_get_font_selection:
1371 * @fsd: a #GtkFontSelectionDialog
1373 * Retrieves the #GtkFontSelection widget embedded in the dialog.
1375 * Returns: (transfer none): the embedded #GtkFontSelection
1380 gtk_font_selection_dialog_get_font_selection (GtkFontSelectionDialog *fsd)
1382 g_return_val_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd), NULL);
1384 return fsd->priv->fontsel;
1389 * gtk_font_selection_dialog_get_ok_button:
1390 * @fsd: a #GtkFontSelectionDialog
1392 * Gets the 'OK' button.
1394 * Return value: (transfer none): the #GtkWidget used in the dialog
1395 * for the 'OK' button.
1400 gtk_font_selection_dialog_get_ok_button (GtkFontSelectionDialog *fsd)
1402 g_return_val_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd), NULL);
1404 return fsd->priv->ok_button;
1408 * gtk_font_selection_dialog_get_cancel_button:
1409 * @fsd: a #GtkFontSelectionDialog
1411 * Gets the 'Cancel' button.
1413 * Return value: (transfer none): the #GtkWidget used in the dialog
1414 * for the 'Cancel' button.
1419 gtk_font_selection_dialog_get_cancel_button (GtkFontSelectionDialog *fsd)
1421 g_return_val_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd), NULL);
1423 return fsd->priv->cancel_button;
1427 gtk_font_selection_dialog_buildable_interface_init (GtkBuildableIface *iface)
1429 parent_buildable_iface = g_type_interface_peek_parent (iface);
1430 iface->get_internal_child = gtk_font_selection_dialog_buildable_get_internal_child;
1434 gtk_font_selection_dialog_buildable_get_internal_child (GtkBuildable *buildable,
1435 GtkBuilder *builder,
1436 const gchar *childname)
1438 GtkFontSelectionDialogPrivate *priv;
1440 priv = GTK_FONT_SELECTION_DIALOG (buildable)->priv;
1442 if (g_strcmp0 (childname, "ok_button") == 0)
1443 return G_OBJECT (priv->ok_button);
1444 else if (g_strcmp0 (childname, "cancel_button") == 0)
1445 return G_OBJECT (priv->cancel_button);
1446 else if (g_strcmp0 (childname, "apply_button") == 0)
1447 return G_OBJECT (priv->apply_button);
1448 else if (g_strcmp0 (childname, "font_selection") == 0)
1449 return G_OBJECT (priv->fontsel);
1451 return parent_buildable_iface->get_internal_child (buildable, builder, childname);
1455 * gtk_font_selection_dialog_get_font_name:
1456 * @fsd: a #GtkFontSelectionDialog
1458 * Gets the currently-selected font name.
1460 * Note that this can be a different string than what you set with
1461 * gtk_font_selection_dialog_set_font_name(), as the font selection widget
1462 * may normalize font names and thus return a string with a different
1463 * structure. For example, "Helvetica Italic Bold 12" could be normalized
1464 * to "Helvetica Bold Italic 12". Use pango_font_description_equal()
1465 * if you want to compare two font descriptions.
1467 * Return value: A string with the name of the current font, or %NULL if no
1468 * font is selected. You must free this string with g_free().
1471 gtk_font_selection_dialog_get_font_name (GtkFontSelectionDialog *fsd)
1473 GtkFontSelectionDialogPrivate *priv;
1475 g_return_val_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd), NULL);
1479 return gtk_font_selection_get_font_name (GTK_FONT_SELECTION (priv->fontsel));
1483 * gtk_font_selection_dialog_set_font_name:
1484 * @fsd: a #GtkFontSelectionDialog
1485 * @fontname: a font name like "Helvetica 12" or "Times Bold 18"
1487 * Sets the currently selected font.
1489 * Return value: %TRUE if the font selected in @fsd is now the
1490 * @fontname specified, %FALSE otherwise.
1493 gtk_font_selection_dialog_set_font_name (GtkFontSelectionDialog *fsd,
1494 const gchar *fontname)
1496 GtkFontSelectionDialogPrivate *priv;
1498 g_return_val_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd), FALSE);
1499 g_return_val_if_fail (fontname, FALSE);
1503 return gtk_font_selection_set_font_name (GTK_FONT_SELECTION (priv->fontsel), fontname);
1507 * gtk_font_selection_dialog_get_preview_text:
1508 * @fsd: a #GtkFontSelectionDialog
1510 * Gets the text displayed in the preview area.
1512 * Return value: the text displayed in the preview area.
1513 * This string is owned by the widget and should not be
1516 G_CONST_RETURN gchar*
1517 gtk_font_selection_dialog_get_preview_text (GtkFontSelectionDialog *fsd)
1519 GtkFontSelectionDialogPrivate *priv;
1521 g_return_val_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd), NULL);
1525 return gtk_font_selection_get_preview_text (GTK_FONT_SELECTION (priv->fontsel));
1529 * gtk_font_selection_dialog_set_preview_text:
1530 * @fsd: a #GtkFontSelectionDialog
1531 * @text: the text to display in the preview area
1533 * Sets the text displayed in the preview area.
1536 gtk_font_selection_dialog_set_preview_text (GtkFontSelectionDialog *fsd,
1539 GtkFontSelectionDialogPrivate *priv;
1541 g_return_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd));
1542 g_return_if_fail (text != NULL);
1546 gtk_font_selection_set_preview_text (GTK_FONT_SELECTION (priv->fontsel), text);