/* GTK - The GIMP Toolkit
- * Copyright (C) 2011 Alberto Ruiz <aruiz@gnome.org>
- * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
+ * gtkfontchooser.h - Abstract interface for font file selectors GUIs
*
- * GtkFontChooser 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.
+ * Copyright (C) 2006, Emmanuele Bassi
+ * Copyright (C) 2011 Alberto Ruiz <aruiz@gnome.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
*
* 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
+ * 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.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
+#ifndef __GTK_FONT_CHOOSER_H__
+#define __GTK_FONT_CHOOSER_H__
+
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk.h> can be included directly."
#endif
-#ifndef __GTK_FONT_CHOOSER_H__
-#define __GTK_FONT_CHOOSER_H__
-
-#include <gtk/gtkvbox.h>
+#include <gtk/gtkwidget.h>
G_BEGIN_DECLS
-#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_FONT_CHOOSER_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_FONT_CHOOSER, GtkFontChooserClass))
-#define GTK_IS_FONT_CHOOSER(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_FONT_CHOOSER))
-#define GTK_IS_FONT_CHOOSER_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_FONT_CHOOSER))
-#define GTK_FONT_CHOOSER_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_FONT_CHOOSER, GtkFontChooserClass))
+/**
+ * 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 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);
+
+#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;
-typedef struct _GtkFontChooserPrivate GtkFontChooserPrivate;
-typedef struct _GtkFontChooserClass GtkFontChooserClass;
+typedef struct _GtkFontChooser GtkFontChooser; /* dummy */
+typedef struct _GtkFontChooserIface GtkFontChooserIface;
-struct _GtkFontChooser
+struct _GtkFontChooserIface
{
- GtkVBox parent_instance;
+ GTypeInterface base_iface;
- /*< private >*/
- GtkFontChooserPrivate *priv;
-};
+ /* Methods */
+ PangoFontFamily * (* get_font_family) (GtkFontChooser *fontchooser);
+ PangoFontFace * (* get_font_face) (GtkFontChooser *fontchooser);
+ gint (* get_font_size) (GtkFontChooser *fontchooser);
-struct _GtkFontChooserClass
-{
- GtkVBoxClass parent_class;
+ void (* set_filter_func) (GtkFontChooser *fontchooser,
+ GtkFontFilterFunc filter,
+ gpointer user_data,
+ GDestroyNotify destroy);
- /* Padding for future expansion */
- void (*_gtk_reserved1) (void);
- void (*_gtk_reserved2) (void);
- void (*_gtk_reserved3) (void);
- void (*_gtk_reserved4) (void);
+ /* Signals */
+ void (* font_activated) (GtkFontChooser *chooser,
+ const gchar *fontname);
+
+ /* Padding */
+ gpointer padding[12];
};
-/*****************************************************************************
- * GtkFontChooser functions.
- * see the comments in the GtkFontChooserDialog functions.
- *****************************************************************************/
-
-GType gtk_font_chooser_get_type (void) G_GNUC_CONST;
-GtkWidget* gtk_font_chooser_new (void);
-PangoFontFamily*
- gtk_font_chooser_get_family (GtkFontChooser *fontchooser);
-PangoFontFace*
- gtk_font_chooser_get_face (GtkFontChooser *fontchooser);
-gint gtk_font_chooser_get_size (GtkFontChooser *fontchooser);
-gchar* gtk_font_chooser_get_font_name (GtkFontChooser *fontchooser);
-
-gboolean gtk_font_chooser_set_font_name (GtkFontChooser *fontchooser,
- const gchar *fontname);
-const gchar* gtk_font_chooser_get_preview_text (GtkFontChooser *fontchooser);
-void gtk_font_chooser_set_preview_text (GtkFontChooser *fontchooser,
- const gchar *text);
-gboolean gtk_font_chooser_get_show_preview_entry (GtkFontChooser *fontchooser);
-void gtk_font_chooser_set_show_preview_entry (GtkFontChooser *fontchooser,
- gboolean show_preview_entry);
+GDK_AVAILABLE_IN_3_2
+GType gtk_font_chooser_get_type (void) G_GNUC_CONST;
+
+GDK_AVAILABLE_IN_3_2
+PangoFontFamily *gtk_font_chooser_get_font_family (GtkFontChooser *fontchooser);
+GDK_AVAILABLE_IN_3_2
+PangoFontFace *gtk_font_chooser_get_font_face (GtkFontChooser *fontchooser);
+GDK_AVAILABLE_IN_3_2
+gint gtk_font_chooser_get_font_size (GtkFontChooser *fontchooser);
+
+GDK_AVAILABLE_IN_3_2
+PangoFontDescription *
+ gtk_font_chooser_get_font_desc (GtkFontChooser *fontchooser);
+GDK_AVAILABLE_IN_3_2
+void gtk_font_chooser_set_font_desc (GtkFontChooser *fontchooser,
+ const PangoFontDescription *font_desc);
+
+GDK_AVAILABLE_IN_3_2
+gchar* gtk_font_chooser_get_font (GtkFontChooser *fontchooser);
+
+GDK_AVAILABLE_IN_3_2
+void gtk_font_chooser_set_font (GtkFontChooser *fontchooser,
+ const gchar *fontname);
+GDK_AVAILABLE_IN_3_2
+gchar* gtk_font_chooser_get_preview_text (GtkFontChooser *fontchooser);
+GDK_AVAILABLE_IN_3_2
+void gtk_font_chooser_set_preview_text (GtkFontChooser *fontchooser,
+ const gchar *text);
+GDK_AVAILABLE_IN_3_2
+gboolean gtk_font_chooser_get_show_preview_entry (GtkFontChooser *fontchooser);
+GDK_AVAILABLE_IN_3_2
+void gtk_font_chooser_set_show_preview_entry (GtkFontChooser *fontchooser,
+ gboolean show_preview_entry);
+GDK_AVAILABLE_IN_3_2
+void gtk_font_chooser_set_filter_func (GtkFontChooser *fontchooser,
+ GtkFontFilterFunc filter,
+ gpointer user_data,
+ GDestroyNotify destroy);
+
+G_END_DECLS
#endif /* __GTK_FONT_CHOOSER_H__ */