1 /* GTK - The GIMP Toolkit
2 * gtkfontchooser.h - Abstract interface for font file selectors GUIs
4 * Copyright (C) 2006, Emmanuele Bassi
5 * Copyright (C) 2011 Alberto Ruiz <aruiz@gnome.org>
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 * Boston, MA 02111-1307, USA.
23 #if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
24 #error "Only <gtk/gtk.h> can be included directly."
27 #ifndef __GTK_FONT_CHOOSER_H__
28 #define __GTK_FONT_CHOOSER_H__
30 #include <gtk/gtkwidget.h>
36 * @family: a #PangoFontFamily
37 * @face: a #PangoFontFace belonging to @family
38 * @data: (closure): user data passed to gtk_font_chooser_set_filter_func()
40 * The type of function that is used for deciding what fonts get
41 * shown in a #GtkFontChooser. See gtk_font_chooser_set_filter_func().
43 * Returns: %TRUE if the font should be displayed
45 typedef gboolean (*GtkFontFilterFunc) (const PangoFontFamily *family,
46 const PangoFontFace *face,
49 #define GTK_TYPE_FONT_CHOOSER (gtk_font_chooser_get_type ())
50 #define GTK_FONT_CHOOSER(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_FONT_CHOOSER, GtkFontChooser))
51 #define GTK_IS_FONT_CHOOSER(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_FONT_CHOOSER))
52 #define GTK_FONT_CHOOSER_GET_IFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE ((inst), GTK_TYPE_FONT_CHOOSER, GtkFontChooserIface))
54 typedef struct _GtkFontChooser GtkFontChooser; /* dummy */
55 typedef struct _GtkFontChooserIface GtkFontChooserIface;
57 struct _GtkFontChooserIface
59 GTypeInterface base_iface;
62 PangoFontFamily * (* get_font_family) (GtkFontChooser *chooser);
63 PangoFontFace * (* get_font_face) (GtkFontChooser *chooser);
64 gint (* get_font_size) (GtkFontChooser *chooser);
66 void (* set_filter_func) (GtkFontChooser *chooser,
67 GtkFontFilterFunc filter,
69 GDestroyNotify destroy);
72 void (* font_activated) (GtkFontChooser *chooser,
73 const gchar *fontname);
79 GType gtk_font_chooser_get_type (void) G_GNUC_CONST;
81 PangoFontFamily *gtk_font_chooser_get_font_family (GtkFontChooser *fontchooser);
82 PangoFontFace *gtk_font_chooser_get_font_face (GtkFontChooser *fontchooser);
83 gint gtk_font_chooser_get_font_size (GtkFontChooser *fontchooser);
85 PangoFontDescription *
86 gtk_font_chooser_get_font_desc (GtkFontChooser *fontchooser);
87 void gtk_font_chooser_set_font_desc (GtkFontChooser *fontchooser,
88 const PangoFontDescription *font_desc);
90 gchar* gtk_font_chooser_get_font (GtkFontChooser *fontchooser);
92 void gtk_font_chooser_set_font (GtkFontChooser *fontchooser,
93 const gchar *fontname);
94 gchar* gtk_font_chooser_get_preview_text (GtkFontChooser *fontchooser);
95 void gtk_font_chooser_set_preview_text (GtkFontChooser *fontchooser,
97 gboolean gtk_font_chooser_get_show_preview_entry (GtkFontChooser *fontchooser);
98 void gtk_font_chooser_set_show_preview_entry (GtkFontChooser *fontchooser,
99 gboolean show_preview_entry);
100 void gtk_font_chooser_set_filter_func (GtkFontChooser *fontchooser,
101 GtkFontFilterFunc filter,
103 GDestroyNotify destroy);
107 #endif /* __GTK_FONT_CHOOSER_H__ */