2011-04-15 20:07:32 +00:00
|
|
|
/* GTK - The GIMP Toolkit
|
2011-09-11 23:49:26 +00:00
|
|
|
* gtkfontchooser.h - Abstract interface for font file selectors GUIs
|
|
|
|
*
|
|
|
|
* Copyright (C) 2006, Emmanuele Bassi
|
|
|
|
* Copyright (C) 2011 Alberto Ruiz <aruiz@gnome.org>
|
2011-04-15 20:07:32 +00:00
|
|
|
*
|
|
|
|
* 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
|
2011-09-11 23:49:26 +00:00
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
2011-04-15 20:07:32 +00:00
|
|
|
* Lesser General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
2012-02-27 13:01:10 +00:00
|
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
2011-04-15 20:07:32 +00:00
|
|
|
*/
|
|
|
|
|
2012-12-28 14:57:34 +00:00
|
|
|
#ifndef __GTK_FONT_CHOOSER_H__
|
|
|
|
#define __GTK_FONT_CHOOSER_H__
|
|
|
|
|
2011-04-15 20:07:32 +00:00
|
|
|
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
|
|
|
|
#error "Only <gtk/gtk.h> can be included directly."
|
|
|
|
#endif
|
|
|
|
|
2011-09-11 23:49:26 +00:00
|
|
|
#include <gtk/gtkwidget.h>
|
2011-04-15 20:07:32 +00:00
|
|
|
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
2011-08-15 02:20:00 +00:00
|
|
|
/**
|
|
|
|
* GtkFontFilterFunc:
|
2021-05-20 13:17:04 +00:00
|
|
|
* @family: a `PangoFontFamily`
|
|
|
|
* @face: a `PangoFontFace` belonging to @family
|
2011-09-11 23:49:26 +00:00
|
|
|
* @data: (closure): user data passed to gtk_font_chooser_set_filter_func()
|
2011-08-15 02:20:00 +00:00
|
|
|
*
|
|
|
|
* The type of function that is used for deciding what fonts get
|
2021-02-26 21:11:01 +00:00
|
|
|
* shown in a `GtkFontChooser`.
|
|
|
|
*
|
|
|
|
* See [method@Gtk.FontChooser.set_filter_func].
|
2011-08-15 02:20:00 +00:00
|
|
|
*
|
|
|
|
* Returns: %TRUE if the font should be displayed
|
|
|
|
*/
|
|
|
|
typedef gboolean (*GtkFontFilterFunc) (const PangoFontFamily *family,
|
|
|
|
const PangoFontFace *face,
|
|
|
|
gpointer data);
|
|
|
|
|
2017-12-21 15:51:04 +00:00
|
|
|
/**
|
|
|
|
* GtkFontChooserLevel:
|
2018-03-27 20:10:19 +00:00
|
|
|
* @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
|
2018-04-01 01:01:47 +00:00
|
|
|
* @GTK_FONT_CHOOSER_LEVEL_VARIATIONS: Allow changing OpenType font variation axes
|
2018-03-27 20:10:19 +00:00
|
|
|
* @GTK_FONT_CHOOSER_LEVEL_FEATURES: Allow selecting specific OpenType font features
|
2017-12-21 15:51:04 +00:00
|
|
|
*
|
2021-02-26 21:11:01 +00:00
|
|
|
* Specifies the granularity of font selection
|
|
|
|
* that is desired in a `GtkFontChooser`.
|
2018-03-27 20:10:19 +00:00
|
|
|
*
|
|
|
|
* This enumeration may be extended in the future; applications should
|
|
|
|
* ignore unknown values.
|
2017-12-21 15:51:04 +00:00
|
|
|
*/
|
|
|
|
typedef enum {
|
2018-04-01 01:01:47 +00:00
|
|
|
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
|
2017-12-21 15:51:04 +00:00
|
|
|
} GtkFontChooserLevel;
|
|
|
|
|
2011-09-11 23:49:26 +00:00
|
|
|
#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 */
|
2012-05-30 21:29:30 +00:00
|
|
|
PangoFontFamily * (* get_font_family) (GtkFontChooser *fontchooser);
|
|
|
|
PangoFontFace * (* get_font_face) (GtkFontChooser *fontchooser);
|
2020-07-24 13:54:49 +00:00
|
|
|
int (* get_font_size) (GtkFontChooser *fontchooser);
|
2011-09-05 20:55:05 +00:00
|
|
|
|
2012-05-30 21:29:30 +00:00
|
|
|
void (* set_filter_func) (GtkFontChooser *fontchooser,
|
2011-09-11 23:49:26 +00:00
|
|
|
GtkFontFilterFunc filter,
|
2012-05-30 21:29:30 +00:00
|
|
|
gpointer user_data,
|
2011-09-11 23:49:26 +00:00
|
|
|
GDestroyNotify destroy);
|
|
|
|
|
|
|
|
/* Signals */
|
|
|
|
void (* font_activated) (GtkFontChooser *chooser,
|
2020-07-24 18:40:36 +00:00
|
|
|
const char *fontname);
|
2011-09-11 23:49:26 +00:00
|
|
|
|
2015-06-13 03:55:30 +00:00
|
|
|
/* More methods */
|
|
|
|
void (* set_font_map) (GtkFontChooser *fontchooser,
|
2015-06-21 00:29:18 +00:00
|
|
|
PangoFontMap *fontmap);
|
2015-06-13 03:55:30 +00:00
|
|
|
PangoFontMap * (* get_font_map) (GtkFontChooser *fontchooser);
|
|
|
|
|
2021-02-25 11:35:33 +00:00
|
|
|
/*< private >*/
|
|
|
|
/* Padding; remove in GTK-next */
|
2015-06-13 03:55:30 +00:00
|
|
|
gpointer padding[10];
|
2011-09-11 23:49:26 +00:00
|
|
|
};
|
|
|
|
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2011-09-11 23:49:26 +00:00
|
|
|
GType gtk_font_chooser_get_type (void) G_GNUC_CONST;
|
|
|
|
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2011-09-11 22:17:58 +00:00
|
|
|
PangoFontFamily *gtk_font_chooser_get_font_family (GtkFontChooser *fontchooser);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2011-09-11 22:17:58 +00:00
|
|
|
PangoFontFace *gtk_font_chooser_get_font_face (GtkFontChooser *fontchooser);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2020-07-24 13:54:49 +00:00
|
|
|
int gtk_font_chooser_get_font_size (GtkFontChooser *fontchooser);
|
2011-09-11 22:13:26 +00:00
|
|
|
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2011-09-11 22:13:26 +00:00
|
|
|
PangoFontDescription *
|
|
|
|
gtk_font_chooser_get_font_desc (GtkFontChooser *fontchooser);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2011-09-11 22:13:26 +00:00
|
|
|
void gtk_font_chooser_set_font_desc (GtkFontChooser *fontchooser,
|
|
|
|
const PangoFontDescription *font_desc);
|
|
|
|
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2020-07-24 18:40:36 +00:00
|
|
|
char * gtk_font_chooser_get_font (GtkFontChooser *fontchooser);
|
2011-09-11 23:49:26 +00:00
|
|
|
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2011-09-05 20:45:44 +00:00
|
|
|
void gtk_font_chooser_set_font (GtkFontChooser *fontchooser,
|
2020-07-24 18:40:36 +00:00
|
|
|
const char *fontname);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2020-07-24 18:40:36 +00:00
|
|
|
char * gtk_font_chooser_get_preview_text (GtkFontChooser *fontchooser);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2011-09-11 23:49:26 +00:00
|
|
|
void gtk_font_chooser_set_preview_text (GtkFontChooser *fontchooser,
|
2020-07-24 18:40:36 +00:00
|
|
|
const char *text);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2011-09-11 23:49:26 +00:00
|
|
|
gboolean gtk_font_chooser_get_show_preview_entry (GtkFontChooser *fontchooser);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2011-09-11 23:49:26 +00:00
|
|
|
void gtk_font_chooser_set_show_preview_entry (GtkFontChooser *fontchooser,
|
|
|
|
gboolean show_preview_entry);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2011-09-11 23:49:26 +00:00
|
|
|
void gtk_font_chooser_set_filter_func (GtkFontChooser *fontchooser,
|
|
|
|
GtkFontFilterFunc filter,
|
|
|
|
gpointer user_data,
|
|
|
|
GDestroyNotify destroy);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2015-05-05 03:21:17 +00:00
|
|
|
void gtk_font_chooser_set_font_map (GtkFontChooser *fontchooser,
|
|
|
|
PangoFontMap *fontmap);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2015-05-05 03:21:17 +00:00
|
|
|
PangoFontMap * gtk_font_chooser_get_font_map (GtkFontChooser *fontchooser);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2017-12-21 15:51:04 +00:00
|
|
|
void gtk_font_chooser_set_level (GtkFontChooser *fontchooser,
|
|
|
|
GtkFontChooserLevel level);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2017-12-21 15:51:04 +00:00
|
|
|
GtkFontChooserLevel
|
|
|
|
gtk_font_chooser_get_level (GtkFontChooser *fontchooser);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2018-01-03 04:52:24 +00:00
|
|
|
char * gtk_font_chooser_get_font_features (GtkFontChooser *fontchooser);
|
2018-02-05 19:13:20 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2018-01-03 04:52:24 +00:00
|
|
|
char * gtk_font_chooser_get_language (GtkFontChooser *fontchooser);
|
2018-04-02 17:34:22 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
|
|
void gtk_font_chooser_set_language (GtkFontChooser *fontchooser,
|
|
|
|
const char *language);
|
2011-08-15 02:20:00 +00:00
|
|
|
|
2022-09-24 01:54:15 +00:00
|
|
|
G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkFontChooser, g_object_unref)
|
|
|
|
|
2011-07-27 12:04:21 +00:00
|
|
|
G_END_DECLS
|
2011-04-15 20:07:32 +00:00
|
|
|
|
2011-05-11 20:52:39 +00:00
|
|
|
#endif /* __GTK_FONT_CHOOSER_H__ */
|