/* GTK - The GIMP Toolkit * gtkfontchooser.h - Abstract interface for font file selectors GUIs * * Copyright (C) 2006, Emmanuele Bassi * Copyright (C) 2011 Alberto Ruiz * * 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, see . */ #ifndef __GTK_FONT_CHOOSER_H__ #define __GTK_FONT_CHOOSER_H__ #if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) #error "Only can be included directly." #endif #include G_BEGIN_DECLS /** * GtkFontFilterFunc: * @family: a `PangoFontFamily` * @face: a `PangoFontFace` belonging to @family * @data: (closure): user data passed to gtk_font_chooser_set_filter_func() * * The type of function that is used for deciding what fonts get * shown in a `GtkFontChooser`. * * See [method@Gtk.FontChooser.set_filter_func]. * * Returns: %TRUE if the font should be displayed */ typedef gboolean (*GtkFontFilterFunc) (const PangoFontFamily *family, const PangoFontFace *face, gpointer data); /** * 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 * @GTK_FONT_CHOOSER_LEVEL_VARIATIONS: Allow changing OpenType font variation axes * @GTK_FONT_CHOOSER_LEVEL_FEATURES: Allow selecting specific OpenType font features * * Specifies the granularity of font selection * that is desired in a `GtkFontChooser`. * * This enumeration may be extended in the future; applications should * ignore unknown values. */ typedef enum { 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 } GtkFontChooserLevel; #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 */ PangoFontFamily * (* get_font_family) (GtkFontChooser *fontchooser); PangoFontFace * (* get_font_face) (GtkFontChooser *fontchooser); int (* get_font_size) (GtkFontChooser *fontchooser); void (* set_filter_func) (GtkFontChooser *fontchooser, GtkFontFilterFunc filter, gpointer user_data, GDestroyNotify destroy); /* Signals */ void (* font_activated) (GtkFontChooser *chooser, const char *fontname); /* More methods */ void (* set_font_map) (GtkFontChooser *fontchooser, PangoFontMap *fontmap); PangoFontMap * (* get_font_map) (GtkFontChooser *fontchooser); /*< private >*/ /* Padding; remove in GTK-next */ gpointer padding[10]; }; GDK_AVAILABLE_IN_ALL GType gtk_font_chooser_get_type (void) G_GNUC_CONST; GDK_AVAILABLE_IN_ALL PangoFontFamily *gtk_font_chooser_get_font_family (GtkFontChooser *fontchooser); GDK_AVAILABLE_IN_ALL PangoFontFace *gtk_font_chooser_get_font_face (GtkFontChooser *fontchooser); GDK_AVAILABLE_IN_ALL int gtk_font_chooser_get_font_size (GtkFontChooser *fontchooser); GDK_AVAILABLE_IN_ALL PangoFontDescription * gtk_font_chooser_get_font_desc (GtkFontChooser *fontchooser); GDK_AVAILABLE_IN_ALL void gtk_font_chooser_set_font_desc (GtkFontChooser *fontchooser, const PangoFontDescription *font_desc); GDK_AVAILABLE_IN_ALL char * gtk_font_chooser_get_font (GtkFontChooser *fontchooser); GDK_AVAILABLE_IN_ALL void gtk_font_chooser_set_font (GtkFontChooser *fontchooser, const char *fontname); GDK_AVAILABLE_IN_ALL char * gtk_font_chooser_get_preview_text (GtkFontChooser *fontchooser); GDK_AVAILABLE_IN_ALL void gtk_font_chooser_set_preview_text (GtkFontChooser *fontchooser, const char *text); GDK_AVAILABLE_IN_ALL gboolean gtk_font_chooser_get_show_preview_entry (GtkFontChooser *fontchooser); GDK_AVAILABLE_IN_ALL void gtk_font_chooser_set_show_preview_entry (GtkFontChooser *fontchooser, gboolean show_preview_entry); GDK_AVAILABLE_IN_ALL void gtk_font_chooser_set_filter_func (GtkFontChooser *fontchooser, GtkFontFilterFunc filter, gpointer user_data, GDestroyNotify destroy); GDK_AVAILABLE_IN_ALL void gtk_font_chooser_set_font_map (GtkFontChooser *fontchooser, PangoFontMap *fontmap); GDK_AVAILABLE_IN_ALL PangoFontMap * gtk_font_chooser_get_font_map (GtkFontChooser *fontchooser); GDK_AVAILABLE_IN_ALL void gtk_font_chooser_set_level (GtkFontChooser *fontchooser, GtkFontChooserLevel level); GDK_AVAILABLE_IN_ALL GtkFontChooserLevel gtk_font_chooser_get_level (GtkFontChooser *fontchooser); GDK_AVAILABLE_IN_ALL char * gtk_font_chooser_get_font_features (GtkFontChooser *fontchooser); GDK_AVAILABLE_IN_ALL char * gtk_font_chooser_get_language (GtkFontChooser *fontchooser); GDK_AVAILABLE_IN_ALL void gtk_font_chooser_set_language (GtkFontChooser *fontchooser, const char *language); G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkFontChooser, g_object_unref) G_END_DECLS #endif /* __GTK_FONT_CHOOSER_H__ */