gtkfontchooser.h 7.21 KB
Newer Older
1
/* GTK - The GIMP Toolkit
2
3
4
5
 * gtkfontchooser.h - Abstract interface for font file selectors GUIs
 *
 * Copyright (C) 2006, Emmanuele Bassi
 * Copyright (C) 2011 Alberto Ruiz <aruiz@gnome.org>
6
7
8
9
10
11
12
13
 *
 * 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
14
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15
16
17
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
Javier Jardón's avatar
Javier Jardón committed
18
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
19
20
 */

21
22
23
#ifndef __GTK_FONT_CHOOSER_H__
#define __GTK_FONT_CHOOSER_H__

24
25
26
27
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk.h> can be included directly."
#endif

28
#include <gtk/gtkwidget.h>
29
30
31

G_BEGIN_DECLS

32
33
34
35
/**
 * GtkFontFilterFunc:
 * @family: a #PangoFontFamily
 * @face: a #PangoFontFace belonging to @family
36
 * @data: (closure): user data passed to gtk_font_chooser_set_filter_func()
37
38
39
40
41
42
43
44
45
46
 *
 * The type of function that is used for deciding what fonts get
 * shown in a #GtkFontChooser. See gtk_font_chooser_set_filter_func().
 *
 * Returns: %TRUE if the font should be displayed
 */
typedef gboolean (*GtkFontFilterFunc) (const PangoFontFamily *family,
                                       const PangoFontFace   *face,
                                       gpointer               data);

47
48
49
50
51
/**
 * GtkFontChooserLevel:
 * @GTK_FONT_CHOOSER_LEVEL_FAMILY: Allow selecting a font family
 * @GTK_FONT_CHOOSER_LEVEL_STYLE: Allow selecting a specific font face
 * @GTK_FONT_CHOOSER_LEVEL_SIZE: Allow selecting a specific font size
52
 * @GTK_FONT_CHOOSER_LEVEL_VARIATION: Allow changing OpenType font variation axes
53
 * @GTK_FONT_CHOOSER_LEVEL_FEATURES: Allow selecting specific OpenType font features
54
55
56
57
58
59
60
61
 *
 * This enumeration specifies the granularity of font selection
 * that is desired in a font chooser.
 *
 * This enumeration may be extended in the future; applications should
 * ignore unknown values.
 */
typedef enum {
62
63
64
65
66
  GTK_FONT_CHOOSER_LEVEL_FAMILY     = 0,
  GTK_FONT_CHOOSER_LEVEL_STYLE      = 1 << 0,
  GTK_FONT_CHOOSER_LEVEL_SIZE       = 1 << 1,
  GTK_FONT_CHOOSER_LEVEL_VARIATIONS = 1 << 2,
  GTK_FONT_CHOOSER_LEVEL_FEATURES   = 1 << 3
67
68
} GtkFontChooserLevel;

69
70
71
72
73
74
75
76
77
78
79
80
81
#define GTK_TYPE_FONT_CHOOSER			(gtk_font_chooser_get_type ())
#define GTK_FONT_CHOOSER(obj)			(G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_FONT_CHOOSER, GtkFontChooser))
#define GTK_IS_FONT_CHOOSER(obj)		(G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_FONT_CHOOSER))
#define GTK_FONT_CHOOSER_GET_IFACE(inst)	(G_TYPE_INSTANCE_GET_INTERFACE ((inst), GTK_TYPE_FONT_CHOOSER, GtkFontChooserIface))

typedef struct _GtkFontChooser      GtkFontChooser; /* dummy */
typedef struct _GtkFontChooserIface GtkFontChooserIface;

struct _GtkFontChooserIface
{
  GTypeInterface base_iface;

  /* Methods */
82
83
84
  PangoFontFamily * (* get_font_family)         (GtkFontChooser  *fontchooser);
  PangoFontFace *   (* get_font_face)           (GtkFontChooser  *fontchooser);
  gint              (* get_font_size)           (GtkFontChooser  *fontchooser);
85

86
  void              (* set_filter_func)         (GtkFontChooser   *fontchooser,
87
                                                 GtkFontFilterFunc filter,
88
                                                 gpointer          user_data,
89
90
91
92
93
94
                                                 GDestroyNotify    destroy);

  /* Signals */
  void (* font_activated) (GtkFontChooser *chooser,
                           const gchar    *fontname);

95
96
  /* More methods */
  void              (* set_font_map)            (GtkFontChooser   *fontchooser,
Matthias Clasen's avatar
Matthias Clasen committed
97
                                                 PangoFontMap     *fontmap);
98
99
  PangoFontMap *    (* get_font_map)            (GtkFontChooser   *fontchooser);

Matthias Clasen's avatar
Matthias Clasen committed
100
   /* Padding */
101
  gpointer padding[10];
102
103
};

104
GDK_AVAILABLE_IN_3_2
105
106
GType            gtk_font_chooser_get_type                 (void) G_GNUC_CONST;

107
GDK_AVAILABLE_IN_3_2
108
PangoFontFamily *gtk_font_chooser_get_font_family          (GtkFontChooser   *fontchooser);
109
GDK_AVAILABLE_IN_3_2
110
PangoFontFace   *gtk_font_chooser_get_font_face            (GtkFontChooser   *fontchooser);
111
GDK_AVAILABLE_IN_3_2
112
gint             gtk_font_chooser_get_font_size            (GtkFontChooser   *fontchooser);
113

114
GDK_AVAILABLE_IN_3_2
115
116
PangoFontDescription *
                 gtk_font_chooser_get_font_desc            (GtkFontChooser             *fontchooser);
117
GDK_AVAILABLE_IN_3_2
118
119
120
void             gtk_font_chooser_set_font_desc            (GtkFontChooser             *fontchooser,
                                                            const PangoFontDescription *font_desc);

121
GDK_AVAILABLE_IN_3_2
122
gchar*           gtk_font_chooser_get_font                 (GtkFontChooser   *fontchooser);
123

124
GDK_AVAILABLE_IN_3_2
125
void             gtk_font_chooser_set_font                 (GtkFontChooser   *fontchooser,
126
                                                            const gchar      *fontname);
127
GDK_AVAILABLE_IN_3_2
128
gchar*           gtk_font_chooser_get_preview_text         (GtkFontChooser   *fontchooser);
129
GDK_AVAILABLE_IN_3_2
130
131
void             gtk_font_chooser_set_preview_text         (GtkFontChooser   *fontchooser,
                                                            const gchar      *text);
132
GDK_AVAILABLE_IN_3_2
133
gboolean         gtk_font_chooser_get_show_preview_entry   (GtkFontChooser   *fontchooser);
134
GDK_AVAILABLE_IN_3_2
135
136
void             gtk_font_chooser_set_show_preview_entry   (GtkFontChooser   *fontchooser,
                                                            gboolean          show_preview_entry);
137
GDK_AVAILABLE_IN_3_2
138
139
140
141
void             gtk_font_chooser_set_filter_func          (GtkFontChooser   *fontchooser,
                                                            GtkFontFilterFunc filter,
                                                            gpointer          user_data,
                                                            GDestroyNotify    destroy);
142
143
144
145
146
GDK_AVAILABLE_IN_3_18
void             gtk_font_chooser_set_font_map             (GtkFontChooser   *fontchooser,
                                                            PangoFontMap     *fontmap);
GDK_AVAILABLE_IN_3_18
PangoFontMap *   gtk_font_chooser_get_font_map             (GtkFontChooser   *fontchooser);
147

148
149
150
151
152
153
154
155
156
157
158
159
160
GDK_AVAILABLE_IN_3_24
void             gtk_font_chooser_set_level                (GtkFontChooser   *fontchooser,
                                                            GtkFontChooserLevel level);
GDK_AVAILABLE_IN_3_24
GtkFontChooserLevel
                 gtk_font_chooser_get_level                (GtkFontChooser   *fontchooser);
GDK_AVAILABLE_IN_3_24
char *           gtk_font_chooser_get_font_features        (GtkFontChooser   *fontchooser);
GDK_AVAILABLE_IN_3_24
char *           gtk_font_chooser_get_language             (GtkFontChooser   *fontchooser);
GDK_AVAILABLE_IN_3_24
void             gtk_font_chooser_set_language             (GtkFontChooser   *fontchooser,
                                                            const char       *language);
161

162
G_END_DECLS
163

164
#endif /* __GTK_FONT_CHOOSER_H__ */