/* GTK - The GIMP Toolkit * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * Massively updated for Pango by Owen Taylor, May 2000 * GtkFontSelection widget for Gtk+, by Damon Chaplin, May 1998. * Based on the GnomeFontSelector widget, by Elliot Lee, but major changes. * The GnomeFontSelector was derived from app/text_tool.c in the GIMP. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ /* * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS * file for a list of people on the GTK+ Team. See the ChangeLog * files for a list of changes. These files are distributed with * GTK+ at ftp://ftp.gtk.org/pub/gtk/. */ #include "config.h" #include #include #include #include #include "gtkfontsel.h" #include "gtkbutton.h" #include "gtkcellrenderertext.h" #include "gtkentry.h" #include "gtkframe.h" #include "gtkhbbox.h" #include "gtkhbox.h" #include "gtklabel.h" #include "gtkliststore.h" #include "gtkrc.h" #include "gtkstock.h" #include "gtktable.h" #include "gtktreeselection.h" #include "gtktreeview.h" #include "gtkvbox.h" #include "gtkscrolledwindow.h" #include "gtkintl.h" #include "gtkaccessible.h" #include "gtkbuildable.h" #include "gtkprivate.h" #include "gtkalignment.h" #include "gtkscale.h" #include "gtkbox.h" #include "gtkspinbutton.h" #include "gtkwidget.h" /** * SECTION:gtkfontsel * @Short_description: A widget for selecting fonts * @Title: GtkFontSelection * @See_also: #GtkFontSelectionDialog * * The #GtkFontSelection widget lists the available fonts, styles and sizes, * allowing the user to select a font. * It is used in the #GtkFontSelectionDialog widget to provide a dialog box for * selecting fonts. * * To set the font which is initially selected, use * gtk_font_selection_set_font_name(). * * To get the selected font use gtk_font_selection_get_font_name(). * * To change the text which is shown in the preview area, use * gtk_font_selection_set_preview_text(). */ struct _GtkFontSelectionPrivate { GtkWidget *search_entry; GtkWidget *family_face_list; GtkWidget *size_slider; GtkWidget *size_spin; GtkWidget *preview; GtkListStore *model; GtkTreeModel *filter; gint size; PangoFontFace *face; PangoFontFamily *family; gboolean ignore_slider; }; struct _GtkFontSelectionDialogPrivate { GtkWidget *fontsel; GtkWidget *ok_button; GtkWidget *apply_button; GtkWidget *cancel_button; }; /* We don't enable the font and style entries because they don't add * much in terms of visible effect and have a weird effect on keynav. * the Windows font selector has entries similarly positioned but they * act in conjunction with the associated lists to form a single focus * location. */ #undef INCLUDE_FONT_ENTRIES /* This is the default text shown in the preview entry, though the user can set it. Remember that some fonts only have capital letters. */ #define PREVIEW_TEXT N_("abcdefghijk ABCDEFGHIJK") #define DEFAULT_FONT_NAME "Sans 10" #define MAX_FONT_SIZE 999 /* This is the initial fixed height and the top padding of the preview entry */ #define PREVIEW_HEIGHT 84 #define PREVIEW_TOP_PADDING 6 /* These are the sizes of the font, style & size lists. */ #define FONT_LIST_HEIGHT 136 #define FONT_LIST_WIDTH 190 #define FONT_STYLE_LIST_WIDTH 170 #define FONT_SIZE_LIST_WIDTH 60 #define ROW_FORMAT_STRING "%s %s\n%s" /* These are what we use as the standard font sizes, for the size list. */ #define FONT_SIZES_LENGTH 25 static const guint16 font_sizes[] = { 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 20, 22, 24, 26, 28, 32, 36, 40, 48, 56, 64, 72 }; enum { PROP_0, PROP_FONT_NAME, PROP_PREVIEW_TEXT }; enum { FAMILY_COLUMN, FACE_COLUMN, FAMILY_NAME_COLUMN, TEXT_COLUMN }; static void gtk_font_selection_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec); static void gtk_font_selection_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec); static void gtk_font_selection_finalize (GObject *object); static void gtk_font_selection_screen_changed (GtkWidget *widget, GdkScreen *previous_screen); static void gtk_font_selection_style_updated (GtkWidget *widget); static void gtk_font_selection_ref_family (GtkFontSelection *fontsel, PangoFontFamily *family); static void gtk_font_selection_ref_face (GtkFontSelection *fontsel, PangoFontFace *face); static void gtk_font_selection_bootstrap_fontlist (GtkFontSelection *fontsel); G_DEFINE_TYPE (GtkFontSelection, gtk_font_selection, GTK_TYPE_VBOX) static void gtk_font_selection_class_init (GtkFontSelectionClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass); gobject_class->finalize = gtk_font_selection_finalize; gobject_class->set_property = gtk_font_selection_set_property; gobject_class->get_property = gtk_font_selection_get_property; widget_class->screen_changed = gtk_font_selection_screen_changed; widget_class->style_updated = gtk_font_selection_style_updated; g_object_class_install_property (gobject_class, PROP_FONT_NAME, g_param_spec_string ("font-name", P_("Font name"), P_("The string that represents this font"), DEFAULT_FONT_NAME, GTK_PARAM_READWRITE)); g_object_class_install_property (gobject_class, PROP_PREVIEW_TEXT, g_param_spec_string ("preview-text", P_("Preview text"), P_("The text to display in order to demonstrate the selected font"), _(PREVIEW_TEXT), GTK_PARAM_READWRITE)); g_type_class_add_private (klass, sizeof (GtkFontSelectionPrivate)); } static void gtk_font_selection_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { GtkFontSelection *fontsel; fontsel = GTK_FONT_SELECTION (object); switch (prop_id) { case PROP_FONT_NAME: gtk_font_selection_set_font_name (fontsel, g_value_get_string (value)); break; case PROP_PREVIEW_TEXT: gtk_font_selection_set_preview_text (fontsel, g_value_get_string (value)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void gtk_font_selection_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { GtkFontSelection *fontsel; fontsel = GTK_FONT_SELECTION (object); switch (prop_id) { case PROP_FONT_NAME: g_value_take_string (value, gtk_font_selection_get_font_name (fontsel)); break; case PROP_PREVIEW_TEXT: g_value_set_string (value, gtk_font_selection_get_preview_text (fontsel)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } void deleted_text_cb (GtkEntryBuffer *buffer, guint position, guint n_chars, gpointer user_data) { GtkFontSelectionPrivate *priv = (GtkFontSelectionPrivate*)user_data; GtkWidget *entry = priv->search_entry; if (gtk_entry_buffer_get_length (buffer) == 0) { gtk_entry_set_icon_from_stock (GTK_ENTRY (entry), GTK_ENTRY_ICON_SECONDARY, GTK_STOCK_FIND); } gtk_tree_model_filter_refilter (GTK_TREE_MODEL_FILTER (priv->filter)); } void inserted_text_cb (GtkEntryBuffer *buffer, guint position, gchar *chars, guint n_chars, gpointer user_data) { GtkFontSelectionPrivate *priv = (GtkFontSelectionPrivate*)user_data; GtkWidget *entry = priv->search_entry; if (g_strcmp0 (gtk_entry_get_icon_stock (GTK_ENTRY (entry), GTK_ENTRY_ICON_SECONDARY), GTK_STOCK_CLEAR)) gtk_entry_set_icon_from_stock (GTK_ENTRY (entry), GTK_ENTRY_ICON_SECONDARY, GTK_STOCK_CLEAR); gtk_tree_model_filter_refilter (GTK_TREE_MODEL_FILTER (priv->filter)); } void icon_press_cb (GtkEntry *entry, GtkEntryIconPosition pos, GdkEvent *event, gpointer user_data) { gtk_entry_buffer_delete_text (gtk_entry_get_buffer (entry), 0, -1); } void slider_change_cb (GtkAdjustment *adjustment, gpointer data) { GtkFontSelectionPrivate *priv = (GtkFontSelectionPrivate*)data; /* If we set the silder value manually, we ignore this callback */ if (priv->ignore_slider) { priv->ignore_slider = FALSE; return; } gtk_adjustment_set_value (gtk_spin_button_get_adjustment( GTK_SPIN_BUTTON(priv->size_spin)), gtk_adjustment_get_value (adjustment)); } void spin_change_cb (GtkAdjustment *adjustment, gpointer data) { PangoFontDescription *desc; GtkFontSelectionPrivate *priv = (GtkFontSelectionPrivate*)data; gdouble size = gtk_adjustment_get_value (adjustment); GtkAdjustment *slider_adj = gtk_range_get_adjustment (GTK_RANGE (priv->size_slider)); /* We ignore the slider value change callback for both of this set_value call */ if (size < gtk_adjustment_get_lower (slider_adj)) { priv->ignore_slider = TRUE; gtk_adjustment_set_value (slider_adj, gtk_adjustment_get_lower (slider_adj)); } else if (size > gtk_adjustment_get_upper (slider_adj)) { priv->ignore_slider = TRUE; gtk_adjustment_set_value (slider_adj, gtk_adjustment_get_upper (slider_adj)); } priv->size = ((gint)gtk_adjustment_get_value (adjustment)) * PANGO_SCALE; desc = pango_context_get_font_description (gtk_widget_get_pango_context (priv->preview)); pango_font_description_set_size (desc, priv->size); gtk_widget_modify_font (priv->preview, desc); gtk_widget_queue_draw (priv->preview); } static void gtk_font_selection_init (GtkFontSelection *fontsel) { GtkFontSelectionPrivate *priv; PangoFontDescription *font_desc; GtkWidget *scrolled_win; GtkWidget *alignment; GtkWidget *preview_and_size; GtkWidget *size_controls; #if 0 GList *focus_chain = NULL; AtkObject *atk_obj; #endif fontsel->priv = G_TYPE_INSTANCE_GET_PRIVATE (fontsel, GTK_TYPE_FONT_SELECTION, GtkFontSelectionPrivate); priv = fontsel->priv; gtk_widget_push_composite_child (); /* Creating fundamental widgets for the private struct */ priv->search_entry = gtk_entry_new (); priv->family_face_list = gtk_tree_view_new (); priv->preview = gtk_entry_new (); priv->size_slider = gtk_scale_new_with_range (GTK_ORIENTATION_HORIZONTAL, (gdouble) font_sizes[0], (gdouble) font_sizes[FONT_SIZES_LENGTH - 1], 1.0); priv->size_spin = gtk_spin_button_new_with_range (0.0, (gdouble)(G_MAXINT / PANGO_SCALE), 1.0); /** Bootstrapping widget layout **/ gtk_box_pack_start (GTK_BOX (fontsel), priv->search_entry, FALSE, TRUE, 0); /* Main font family/face view */ scrolled_win = gtk_scrolled_window_new (NULL, NULL); gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_win), GTK_POLICY_NEVER, GTK_POLICY_AUTOMATIC); gtk_container_add (GTK_CONTAINER (scrolled_win), priv->family_face_list); /* Alignment for the preview and size controls */ alignment = gtk_alignment_new (0.5, 0.5, 1.0, 1.0); gtk_alignment_set_padding (GTK_ALIGNMENT (alignment), PREVIEW_TOP_PADDING, 0, 0, 0); gtk_box_pack_start (GTK_BOX (fontsel), scrolled_win, TRUE, TRUE, 0); preview_and_size = gtk_vbox_new (TRUE, 0); gtk_box_set_homogeneous (GTK_BOX (preview_and_size), FALSE); /* The preview entry needs a scrolled window to make sure we have a */ scrolled_win = gtk_scrolled_window_new (NULL, NULL); gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_win), GTK_POLICY_NEVER, GTK_POLICY_AUTOMATIC); gtk_scrolled_window_add_with_viewport (GTK_SCROLLED_WINDOW (scrolled_win), priv->preview); gtk_box_pack_start (GTK_BOX (preview_and_size), scrolled_win, FALSE, FALSE, 0); /* Setting the size requests for various widgets */ gtk_widget_set_size_request (fontsel, -1, 460); gtk_widget_set_size_request (scrolled_win, -1, PREVIEW_HEIGHT); gtk_widget_set_size_request (priv->preview, -1, PREVIEW_HEIGHT - 6); /* Unset the frame on the preview entry and set a shadow in the scrolled window */ gtk_entry_set_has_frame (GTK_ENTRY (priv->preview), FALSE); gtk_scrolled_window_set_shadow_type (GTK_SCROLLED_WINDOW (scrolled_win), GTK_SHADOW_ETCHED_IN); /* Packing the slider and the spin in a hbox */ size_controls = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 0); gtk_scale_set_draw_value (GTK_SCALE (priv->size_slider), FALSE); gtk_box_pack_start (GTK_BOX (size_controls), priv->size_slider, TRUE, TRUE, 0); gtk_box_pack_start (GTK_BOX (size_controls), priv->size_spin, FALSE, TRUE, 0); gtk_box_pack_start (GTK_BOX (preview_and_size), size_controls, FALSE, FALSE, 0); gtk_container_add (GTK_CONTAINER (alignment), preview_and_size); gtk_box_pack_start (GTK_BOX (fontsel), GTK_WIDGET(alignment), FALSE, TRUE, 0); /* Getting the default size */ font_desc = pango_context_get_font_description (gtk_widget_get_pango_context (GTK_WIDGET (fontsel))); priv->size = pango_font_description_get_size (font_desc); priv->face = NULL; priv->family = NULL; gtk_adjustment_set_value (gtk_range_get_adjustment (GTK_RANGE (priv->size_slider)), (gdouble)(priv->size / PANGO_SCALE)); gtk_adjustment_set_value (gtk_spin_button_get_adjustment (GTK_SPIN_BUTTON (priv->size_spin)), (gdouble)(priv->size / PANGO_SCALE)); gtk_widget_show_all (GTK_WIDGET (fontsel)); gtk_widget_hide (GTK_WIDGET (fontsel)); /* Treeview column and model bootstrapping */ gtk_font_selection_bootstrap_fontlist (fontsel); /* Set default preview text */ gtk_entry_set_text (GTK_ENTRY (priv->preview), pango_language_get_sample_string (NULL)); /* Set search icon and place holder text */ gtk_entry_set_icon_from_stock (GTK_ENTRY (priv->search_entry), GTK_ENTRY_ICON_SECONDARY, GTK_STOCK_FIND); gtk_entry_set_placeholder_text (GTK_ENTRY (priv->search_entry), _("Search font name")); /** Callback connections **/ /* Connect to callback for the live search text entry */ g_signal_connect (G_OBJECT (gtk_entry_get_buffer (GTK_ENTRY (priv->search_entry))), "deleted-text", G_CALLBACK (deleted_text_cb), (gpointer)priv); g_signal_connect (G_OBJECT (gtk_entry_get_buffer (GTK_ENTRY (priv->search_entry))), "inserted-text", G_CALLBACK (inserted_text_cb), (gpointer)priv); g_signal_connect (G_OBJECT (priv->search_entry), "icon-press", G_CALLBACK (icon_press_cb), (gpointer)priv); /* Size controls callbacks */ g_signal_connect (G_OBJECT (gtk_range_get_adjustment (GTK_RANGE (priv->size_slider))), "value-changed", G_CALLBACK (slider_change_cb), (gpointer)priv); g_signal_connect (G_OBJECT (gtk_spin_button_get_adjustment (GTK_SPIN_BUTTON (priv->size_spin))), "value-changed", G_CALLBACK (spin_change_cb), (gpointer)priv); priv->ignore_slider = FALSE; gtk_widget_pop_composite_child(); } /** * gtk_font_selection_new: * * Creates a new #GtkFontSelection. * * Return value: a n ew #GtkFontSelection */ GtkWidget * gtk_font_selection_new (void) { GtkFontSelection *fontsel; fontsel = g_object_new (GTK_TYPE_FONT_SELECTION, NULL); return GTK_WIDGET (fontsel); } static int cmp_families (const void *a, const void *b) { const char *a_name = pango_font_family_get_name (*(PangoFontFamily **)a); const char *b_name = pango_font_family_get_name (*(PangoFontFamily **)b); return g_utf8_collate (a_name, b_name); } static void set_cursor_to_iter (GtkTreeView *view, GtkTreeIter *iter) { GtkTreeModel *model = gtk_tree_view_get_model (view); GtkTreePath *path = gtk_tree_model_get_path (model, iter); gtk_tree_view_set_cursor (view, path, NULL, FALSE); gtk_tree_path_free (path); } static void populate_list (GtkTreeView* treeview, GtkListStore* model) { GtkStyleContext *style_context; GdkRGBA g_color; PangoColor p_color; gchar *color_string; GtkTreeIter match_row; gint n_families, i; PangoFontFamily **families; GString *tmp = g_string_new (NULL); pango_context_list_families (gtk_widget_get_pango_context (GTK_WIDGET (treeview)), &families, &n_families); qsort (families, n_families, sizeof (PangoFontFamily *), cmp_families); gtk_list_store_clear (model); /* Get row header font color */ style_context = gtk_widget_get_style_context (GTK_WIDGET (treeview)); gtk_style_context_get_color (style_context, GTK_STATE_FLAG_NORMAL |GTK_STATE_FLAG_INSENSITIVE, &g_color); p_color.red = (guint16)((gdouble)G_MAXUINT16 * g_color.red); p_color.green = (guint16)((gdouble)G_MAXUINT16 * g_color.green); p_color.blue = (guint16)((gdouble)G_MAXUINT16 * g_color.blue); color_string = pango_color_to_string (&p_color); /* Iterate over families and faces */ for (i=0; istr, -1); if ((i == 0 && j == 0) || (!g_ascii_strcasecmp (face_name, "sans") && j == 0)) { match_row = iter; } pango_font_description_free(pango_desc); g_free (font_desc); } g_free (faces); } set_cursor_to_iter (treeview, &match_row); g_string_free (tmp, TRUE); g_free (color_string); g_free (families); } gboolean visible_func (GtkTreeModel *model, GtkTreeIter *iter, gpointer data) { gboolean result = FALSE; GtkFontSelectionPrivate *priv = (GtkFontSelectionPrivate*) data; const gchar *search_text = (const gchar*)gtk_entry_get_text (GTK_ENTRY (priv->search_entry)); gchar *font_name; gchar *font_name_casefold; gchar *search_text_casefold; gtk_tree_model_get (model, iter, FAMILY_NAME_COLUMN, &font_name, -1); /* Covering some corner cases to speed up the result */ if (font_name == NULL || strlen (search_text) > strlen (font_name)) { g_free (font_name); return FALSE; } if (strlen (search_text) == 0) { g_free (font_name); return TRUE; } font_name_casefold = g_utf8_casefold (font_name, -1); search_text_casefold = g_utf8_casefold (search_text, -1); if (g_strrstr (font_name_casefold, search_text_casefold)) result = TRUE; g_free (search_text_casefold); g_free (font_name_casefold); g_free (font_name); return result; } static void gtk_font_selection_bootstrap_fontlist (GtkFontSelection* fontsel) { GtkTreeView *treeview = GTK_TREE_VIEW (fontsel->priv->family_face_list); GtkTreeViewColumn *col; fontsel->priv->model = gtk_list_store_new (4, PANGO_TYPE_FONT_FAMILY, PANGO_TYPE_FONT_FACE, G_TYPE_STRING, G_TYPE_STRING); fontsel->priv->filter = gtk_tree_model_filter_new (GTK_TREE_MODEL (fontsel->priv->model), NULL); gtk_tree_model_filter_set_visible_func (GTK_TREE_MODEL_FILTER (fontsel->priv->filter), visible_func, (gpointer)fontsel->priv, NULL); gtk_tree_view_set_model (treeview, GTK_TREE_MODEL (fontsel->priv->filter)); gtk_tree_view_set_rules_hint (treeview, TRUE); gtk_tree_view_set_headers_visible (treeview, FALSE); col = gtk_tree_view_column_new_with_attributes ("Family", gtk_cell_renderer_text_new (), "markup", TEXT_COLUMN, NULL); gtk_tree_view_append_column (treeview, col); populate_list (treeview, fontsel->priv->model); } static void gtk_font_selection_finalize (GObject *object) { GtkFontSelection *fontsel = GTK_FONT_SELECTION (object); gtk_font_selection_ref_family (fontsel, NULL); gtk_font_selection_ref_face (fontsel, NULL); G_OBJECT_CLASS (gtk_font_selection_parent_class)->finalize (object); } static void gtk_font_selection_screen_changed (GtkWidget *widget, GdkScreen *previous_screen) { return; } static void gtk_font_selection_style_updated (GtkWidget *widget) { GTK_WIDGET_CLASS (gtk_font_selection_parent_class)->style_updated (widget); return; } static void gtk_font_selection_ref_family (GtkFontSelection *fontsel, PangoFontFamily *family) { GtkFontSelectionPrivate *priv = fontsel->priv; if (family) family = g_object_ref (family); if (priv->family) g_object_unref (priv->family); priv->family = family; } static void gtk_font_selection_ref_face (GtkFontSelection *fontsel, PangoFontFace *face) { GtkFontSelectionPrivate *priv = fontsel->priv; if (face) face = g_object_ref (face); if (priv->face) g_object_unref (priv->face); priv->face = face; } /***************************************************************************** * These functions are the main public interface for getting/setting the font. *****************************************************************************/ /** * gtk_font_selection_get_family_list: * @fontsel: a #GtkFontSelection * * This returns the #GtkTreeView that lists font families, for * example, 'Sans', 'Serif', etc. * * Return value: (transfer none): A #GtkWidget that is part of @fontsel * * Deprecated: 3.2 */ GtkWidget * gtk_font_selection_get_family_list (GtkFontSelection *fontsel) { g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL); return NULL; } /** * gtk_font_selection_get_face_list: * @fontsel: a #GtkFontSelection * * This returns the #GtkTreeView which lists all styles available for * the selected font. For example, 'Regular', 'Bold', etc. * * Return value: (transfer none): A #GtkWidget that is part of @fontsel * * Deprecated: 3.2 */ GtkWidget * gtk_font_selection_get_face_list (GtkFontSelection *fontsel) { g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL); return NULL; } /** * gtk_font_selection_get_size_entry: * @fontsel: a #GtkFontSelection * * This returns the #GtkEntry used to allow the user to edit the font * number manually instead of selecting it from the list of font sizes. * * Return value: (transfer none): A #GtkWidget that is part of @fontsel * * Deprecated: 3.2 */ GtkWidget * gtk_font_selection_get_size_entry (GtkFontSelection *fontsel) { g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL); return NULL; } /** * gtk_font_selection_get_size_list: * @fontsel: a #GtkFontSelection * * This returns the #GtkTreeeView used to list font sizes. * * Return value: (transfer none): A #GtkWidget that is part of @fontsel * * Deprecated: 3.2 */ GtkWidget * gtk_font_selection_get_size_list (GtkFontSelection *fontsel) { g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL); return NULL; } /** * gtk_font_selection_get_preview_entry: * @fontsel: a #GtkFontSelection * * This returns the #GtkEntry used to display the font as a preview. * * Return value: (transfer none): A #GtkWidget that is part of @fontsel * * Deprecated: 3.2 */ GtkWidget * gtk_font_selection_get_preview_entry (GtkFontSelection *fontsel) { g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL); return NULL; } /** * gtk_font_selection_get_family: * @fontsel: a #GtkFontSelection * * Gets the #PangoFontFamily representing the selected font family. * * Return value: (transfer none): A #PangoFontFamily representing the * selected font family. Font families are a collection of font * faces. The returned object is owned by @fontsel and must not * be modified or freed. * * Since: 2.14 */ PangoFontFamily * gtk_font_selection_get_family (GtkFontSelection *fontsel) { g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL); return NULL; } /** * gtk_font_selection_get_face: * @fontsel: a #GtkFontSelection * * Gets the #PangoFontFace representing the selected font group * details (i.e. family, slant, weight, width, etc). * * Return value: (transfer none): A #PangoFontFace representing the * selected font group details. The returned object is owned by * @fontsel and must not be modified or freed. * * Since: 2.14 */ PangoFontFace * gtk_font_selection_get_face (GtkFontSelection *fontsel) { g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), NULL); return NULL; } /** * gtk_font_selection_get_size: * @fontsel: a #GtkFontSelection * * The selected font size. * * Return value: A n integer representing the selected font size, * or -1 if no font size is selected. * * Since: 2.14 **/ gint gtk_font_selection_get_size (GtkFontSelection *fontsel) { g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), -1); return fontsel->priv->size; } /** * gtk_font_selection_get_font_name: * @fontsel: a #GtkFontSelection * * Gets the currently-selected font name. * * Note that this can be a different string than what you set with * gtk_font_selection_set_font_name(), as the font selection widget may * normalize font names and thus return a string with a different structure. * For example, "Helvetica Italic Bold 12" could be normalized to * "Helvetica Bold Italic 12". Use pango_font_description_equal() * if you want to compare two font descriptions. * * Return value: A string with the name of the current font, or %NULL if * no font is selected. You must free this string with g_free(). */ gchar * gtk_font_selection_get_font_name (GtkFontSelection *fontsel) { return NULL; } /* This sets the current font, then selecting the appropriate list rows. */ /** * gtk_font_selection_set_font_name: * @fontsel: a #GtkFontSelection * @fontname: a font name like "Helvetica 12" or "Times Bold 18" * * Sets the currently-selected font. * * Note that the @fontsel needs to know the screen in which it will appear * for this to work; this can be guaranteed by simply making sure that the * @fontsel is inserted in a toplevel window before you call this function. * * Return value: %TRUE if the font could be set successfully; %FALSE if no * such font exists or if the @fontsel doesn't belong to a particular * screen yet. */ gboolean gtk_font_selection_set_font_name (GtkFontSelection *fontsel, const gchar *fontname) { #if 0 PangoFontFamily *family = NULL; PangoFontFace *face = NULL; PangoFontDescription *new_desc; #endif g_return_val_if_fail (GTK_IS_FONT_SELECTION (fontsel), FALSE); return TRUE; } /** * gtk_font_selection_get_preview_text: * @fontsel: a #GtkFontSelection * * Gets the text displayed in the preview area. * * Return value: the text displayed in the preview area. * This string is owned by the widget and should not be * modified or freed */ G_CONST_RETURN gchar* gtk_font_selection_get_preview_text (GtkFontSelection *fontsel) { return NULL; } /** * gtk_font_selection_set_preview_text: * @fontsel: a #GtkFontSelection * @text: the text to display in the preview area * * Sets the text displayed in the preview area. * The @text is used to show how the selected font looks. */ void gtk_font_selection_set_preview_text (GtkFontSelection *fontsel, const gchar *text) { #if 0 GtkFontSelectionPrivate *priv; g_return_if_fail (GTK_IS_FONT_SELECTION (fontsel)); g_return_if_fail (text != NULL); priv = fontsel->priv; #endif } /** * SECTION:gtkfontseldlg * @Short_description: A dialog box for selecting fonts * @Title: GtkFontSelectionDialog * @See_also: #GtkFontSelection, #GtkDialog * * The #GtkFontSelectionDialog widget is a dialog box for selecting a font. * * To set the font which is initially selected, use * gtk_font_selection_dialog_set_font_name(). * * To get the selected font use gtk_font_selection_dialog_get_font_name(). * * To change the text which is shown in the preview area, use * gtk_font_selection_dialog_set_preview_text(). * * * GtkFontSelectionDialog as GtkBuildable * The GtkFontSelectionDialog implementation of the GtkBuildable interface * exposes the embedded #GtkFontSelection as internal child with the * name "font_selection". It also exposes the buttons with the names * "ok_button", "cancel_button" and "apply_button". * */ static void gtk_font_selection_dialog_buildable_interface_init (GtkBuildableIface *iface); static GObject * gtk_font_selection_dialog_buildable_get_internal_child (GtkBuildable *buildable, GtkBuilder *builder, const gchar *childname); G_DEFINE_TYPE_WITH_CODE (GtkFontSelectionDialog, gtk_font_selection_dialog, GTK_TYPE_DIALOG, G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE, gtk_font_selection_dialog_buildable_interface_init)) static GtkBuildableIface *parent_buildable_iface; static void gtk_font_selection_dialog_class_init (GtkFontSelectionDialogClass *klass) { g_type_class_add_private (klass, sizeof (GtkFontSelectionDialogPrivate)); } static void gtk_font_selection_dialog_init (GtkFontSelectionDialog *fontseldiag) { GtkFontSelectionDialogPrivate *priv; GtkDialog *dialog = GTK_DIALOG (fontseldiag); GtkWidget *action_area, *content_area; fontseldiag->priv = G_TYPE_INSTANCE_GET_PRIVATE (fontseldiag, GTK_TYPE_FONT_SELECTION_DIALOG, GtkFontSelectionDialogPrivate); priv = fontseldiag->priv; content_area = gtk_dialog_get_content_area (dialog); action_area = gtk_dialog_get_action_area (dialog); gtk_container_set_border_width (GTK_CONTAINER (dialog), 5); gtk_box_set_spacing (GTK_BOX (content_area), 2); /* 2 * 5 + 2 = 12 */ gtk_container_set_border_width (GTK_CONTAINER (action_area), 5); gtk_box_set_spacing (GTK_BOX (action_area), 6); gtk_widget_push_composite_child (); gtk_window_set_resizable (GTK_WINDOW (fontseldiag), TRUE); /* Create the content area */ priv->fontsel = gtk_font_selection_new (); gtk_container_set_border_width (GTK_CONTAINER (priv->fontsel), 5); gtk_widget_show (priv->fontsel); gtk_box_pack_start (GTK_BOX (content_area), priv->fontsel, TRUE, TRUE, 0); /* Create the action area */ priv->cancel_button = gtk_dialog_add_button (dialog, GTK_STOCK_CANCEL, GTK_RESPONSE_CANCEL); priv->apply_button = gtk_dialog_add_button (dialog, GTK_STOCK_APPLY, GTK_RESPONSE_APPLY); gtk_widget_hide (priv->apply_button); priv->ok_button = gtk_dialog_add_button (dialog, GTK_STOCK_OK, GTK_RESPONSE_OK); gtk_widget_grab_default (priv->ok_button); gtk_dialog_set_alternative_button_order (GTK_DIALOG (fontseldiag), GTK_RESPONSE_OK, GTK_RESPONSE_APPLY, GTK_RESPONSE_CANCEL, -1); gtk_window_set_title (GTK_WINDOW (fontseldiag), _("Font Selection")); gtk_widget_pop_composite_child (); } /** * gtk_font_selection_dialog_new: * @title: the title of the dialog window * * Creates a new #GtkFontSelectionDialog. * * Return value: a new #GtkFontSelectionDialog */ GtkWidget* gtk_font_selection_dialog_new (const gchar *title) { GtkFontSelectionDialog *fontseldiag; fontseldiag = g_object_new (GTK_TYPE_FONT_SELECTION_DIALOG, NULL); if (title) gtk_window_set_title (GTK_WINDOW (fontseldiag), title); return GTK_WIDGET (fontseldiag); } /** * gtk_font_selection_dialog_get_font_selection: * @fsd: a #GtkFontSelectionDialog * * Retrieves the #GtkFontSelection widget embedded in the dialog. * * Returns: (transfer none): the embedded #GtkFontSelection * * Since: 2.22 **/ GtkWidget* gtk_font_selection_dialog_get_font_selection (GtkFontSelectionDialog *fsd) { g_return_val_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd), NULL); return fsd->priv->fontsel; } /** * gtk_font_selection_dialog_get_ok_button: * @fsd: a #GtkFontSelectionDialog * * Gets the 'OK' button. * * Return value: (transfer none): the #GtkWidget used in the dialog * for the 'OK' button. * * Since: 2.14 */ GtkWidget * gtk_font_selection_dialog_get_ok_button (GtkFontSelectionDialog *fsd) { g_return_val_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd), NULL); return fsd->priv->ok_button; } /** * gtk_font_selection_dialog_get_cancel_button: * @fsd: a #GtkFontSelectionDialog * * Gets the 'Cancel' button. * * Return value: (transfer none): the #GtkWidget used in the dialog * for the 'Cancel' button. * * Since: 2.14 */ GtkWidget * gtk_font_selection_dialog_get_cancel_button (GtkFontSelectionDialog *fsd) { g_return_val_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd), NULL); return fsd->priv->cancel_button; } static void gtk_font_selection_dialog_buildable_interface_init (GtkBuildableIface *iface) { parent_buildable_iface = g_type_interface_peek_parent (iface); iface->get_internal_child = gtk_font_selection_dialog_buildable_get_internal_child; } static GObject * gtk_font_selection_dialog_buildable_get_internal_child (GtkBuildable *buildable, GtkBuilder *builder, const gchar *childname) { GtkFontSelectionDialogPrivate *priv; priv = GTK_FONT_SELECTION_DIALOG (buildable)->priv; if (g_strcmp0 (childname, "ok_button") == 0) return G_OBJECT (priv->ok_button); else if (g_strcmp0 (childname, "cancel_button") == 0) return G_OBJECT (priv->cancel_button); else if (g_strcmp0 (childname, "apply_button") == 0) return G_OBJECT (priv->apply_button); else if (g_strcmp0 (childname, "font_selection") == 0) return G_OBJECT (priv->fontsel); return parent_buildable_iface->get_internal_child (buildable, builder, childname); } /** * gtk_font_selection_dialog_get_font_name: * @fsd: a #GtkFontSelectionDialog * * Gets the currently-selected font name. * * Note that this can be a different string than what you set with * gtk_font_selection_dialog_set_font_name(), as the font selection widget * may normalize font names and thus return a string with a different * structure. For example, "Helvetica Italic Bold 12" could be normalized * to "Helvetica Bold Italic 12". Use pango_font_description_equal() * if you want to compare two font descriptions. * * Return value: A string with the name of the current font, or %NULL if no * font is selected. You must free this string with g_free(). */ gchar* gtk_font_selection_dialog_get_font_name (GtkFontSelectionDialog *fsd) { GtkFontSelectionDialogPrivate *priv; g_return_val_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd), NULL); priv = fsd->priv; return gtk_font_selection_get_font_name (GTK_FONT_SELECTION (priv->fontsel)); } /** * gtk_font_selection_dialog_set_font_name: * @fsd: a #GtkFontSelectionDialog * @fontname: a font name like "Helvetica 12" or "Times Bold 18" * * Sets the currently selected font. * * Return value: %TRUE if the font selected in @fsd is now the * @fontname specified, %FALSE otherwise. */ gboolean gtk_font_selection_dialog_set_font_name (GtkFontSelectionDialog *fsd, const gchar *fontname) { GtkFontSelectionDialogPrivate *priv; g_return_val_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd), FALSE); g_return_val_if_fail (fontname, FALSE); priv = fsd->priv; return gtk_font_selection_set_font_name (GTK_FONT_SELECTION (priv->fontsel), fontname); } /** * gtk_font_selection_dialog_get_preview_text: * @fsd: a #GtkFontSelectionDialog * * Gets the text displayed in the preview area. * * Return value: the text displayed in the preview area. * This string is owned by the widget and should not be * modified or freed */ G_CONST_RETURN gchar* gtk_font_selection_dialog_get_preview_text (GtkFontSelectionDialog *fsd) { GtkFontSelectionDialogPrivate *priv; g_return_val_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd), NULL); priv = fsd->priv; return gtk_font_selection_get_preview_text (GTK_FONT_SELECTION (priv->fontsel)); } /** * gtk_font_selection_dialog_set_preview_text: * @fsd: a #GtkFontSelectionDialog * @text: the text to display in the preview area * * Sets the text displayed in the preview area. */ void gtk_font_selection_dialog_set_preview_text (GtkFontSelectionDialog *fsd, const gchar *text) { GtkFontSelectionDialogPrivate *priv; g_return_if_fail (GTK_IS_FONT_SELECTION_DIALOG (fsd)); g_return_if_fail (text != NULL); priv = fsd->priv; gtk_font_selection_set_preview_text (GTK_FONT_SELECTION (priv->fontsel), text); }