AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
32ad0ffa0f
gtk2/gtk/gtkfontchooser.h

165 lines
7.2 KiB
C
Raw Normal View History

GtkFontChooser: Remove all cruft from the current GtkFontSelection implementation and start a new widget
2011-04-15 20:07:32 +00:00
/* GTK - The GIMP Toolkit
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
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>
GtkFontChooser: Remove all cruft from the current GtkFontSelection implementation and start a new widget
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
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
2011-09-11 23:49:26 +00:00
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
GtkFontChooser: Remove all cruft from the current GtkFontSelection implementation and start a new widget
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
Change FSF Address
2012-02-27 13:01:10 +00:00
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
GtkFontChooser: Remove all cruft from the current GtkFontSelection implementation and start a new widget
2011-04-15 20:07:32 +00:00
*/
Move single-include guards inside include guards gcc has optimizations for include guards that only work if they are outermost in the the header. https://bugzilla.gnome.org/show_bug.cgi?id=689810
2012-12-28 14:57:34 +00:00
#ifndef __GTK_FONT_CHOOSER_H__
#define __GTK_FONT_CHOOSER_H__
GtkFontChooser: Remove all cruft from the current GtkFontSelection implementation and start a new widget
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
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
2011-09-11 23:49:26 +00:00
#include <gtk/gtkwidget.h>
GtkFontChooser: Remove all cruft from the current GtkFontSelection implementation and start a new widget
2011-04-15 20:07:32 +00:00
G_BEGIN_DECLS
Add filtering to the font chooser
2011-08-15 02:20:00 +00:00
/**
* GtkFontFilterFunc:
* @family: a #PangoFontFamily
* @face: a #PangoFontFace belonging to @family
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
2011-09-11 23:49:26 +00:00
* @data: (closure): user data passed to gtk_font_chooser_set_filter_func()
Add filtering to the font chooser
2011-08-15 02:20:00 +00:00
*
* 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);
font chooser: introduce font chooser levels This is a more systematic approach to reducing the level of detail in the font chooser.
2018-03-30 19:02:49 +00:00
/**
* 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
font chooser: Support font variations Add sliders for the axes on the tweak page.
2018-03-31 18:43:04 +00:00
* @GTK_FONT_CHOOSER_LEVEL_VARIATION: Allow changing OpenType font variation axes
font chooser: Add font features Populate the tweak page with OpenType font features.
2018-03-31 13:37:18 +00:00
* @GTK_FONT_CHOOSER_LEVEL_FEATURES: Allow selecting specific OpenType font features
font chooser: introduce font chooser levels This is a more systematic approach to reducing the level of detail in the font chooser.
2018-03-30 19:02:49 +00:00
*
* 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 {
font chooser: Support font variations Add sliders for the axes on the tweak page.
2018-03-31 18:43:04 +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
font chooser: introduce font chooser levels This is a more systematic approach to reducing the level of detail in the font chooser.
2018-03-30 19:02:49 +00:00
} GtkFontChooserLevel;
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
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 */
fontchooser: silence g-i scanner warning These parameters should be named the same in the definition and the declaration. https://bugzilla.gnome.org/show_bug.cgi?id=677127
2012-05-30 21:29:30 +00:00
PangoFontFamily * (* get_font_family) (GtkFontChooser *fontchooser);
PangoFontFace * (* get_font_face) (GtkFontChooser *fontchooser);
gint (* get_font_size) (GtkFontChooser *fontchooser);
Remove GtkFontChooser:[sg]et_font Now that the setter doesn't return a value anymore, we can just use g_object_[sg]et instead of having these vfuncs.
2011-09-05 20:55:05 +00:00
fontchooser: silence g-i scanner warning These parameters should be named the same in the definition and the declaration. https://bugzilla.gnome.org/show_bug.cgi?id=677127
2012-05-30 21:29:30 +00:00
void (* set_filter_func) (GtkFontChooser *fontchooser,
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
2011-09-11 23:49:26 +00:00
GtkFontFilterFunc filter,
fontchooser: silence g-i scanner warning These parameters should be named the same in the definition and the declaration. https://bugzilla.gnome.org/show_bug.cgi?id=677127
2012-05-30 21:29:30 +00:00
gpointer user_data,
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
2011-09-11 23:49:26 +00:00
GDestroyNotify destroy);
/* Signals */
void (* font_activated) (GtkFontChooser *chooser,
const gchar *fontname);
Redo font map support in GtkFontChooser We can't add properties to the interface, since it breaks 3rd party implementations of the GtkFontChooser interface. These exist, for example in gnumeric. So, instead of a new property, add getter/setter vfuncs.
2015-06-13 03:55:30 +00:00
/* More methods */
void (* set_font_map) (GtkFontChooser *fontchooser,
Pacify gobject-introspection gobject-introspection complains about the parameter names of vfuncs. Why, you ask ? No idea.
2015-06-21 00:29:18 +00:00
PangoFontMap *fontmap);
Redo font map support in GtkFontChooser We can't add properties to the interface, since it breaks 3rd party implementations of the GtkFontChooser interface. These exist, for example in gnumeric. So, instead of a new property, add getter/setter vfuncs.
2015-06-13 03:55:30 +00:00
PangoFontMap * (* get_font_map) (GtkFontChooser *fontchooser);
Typo fix
2012-01-30 23:37:47 +00:00
/* Padding */
Redo font map support in GtkFontChooser We can't add properties to the interface, since it breaks 3rd party implementations of the GtkFontChooser interface. These exist, for example in gnumeric. So, instead of a new property, add getter/setter vfuncs.
2015-06-13 03:55:30 +00:00
gpointer padding[10];
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
2011-09-11 23:49:26 +00:00
};
gtk: Use versioned deprecations This patch changes all uses of GDK_DEPRECATED(_FOR) in gtk headers by the versioned variants, GDK_DEPRECATED_IN_3_x(_FOR). At the same time, we add GDK_AVAILABLE_IN_3_x annotations for all API additions in 3.2 and 3.4.
2012-02-27 12:10:59 +00:00
GDK_AVAILABLE_IN_3_2
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
2011-09-11 23:49:26 +00:00
GType gtk_font_chooser_get_type (void) G_GNUC_CONST;
gtk: Use versioned deprecations This patch changes all uses of GDK_DEPRECATED(_FOR) in gtk headers by the versioned variants, GDK_DEPRECATED_IN_3_x(_FOR). At the same time, we add GDK_AVAILABLE_IN_3_x annotations for all API additions in 3.2 and 3.4.
2012-02-27 12:10:59 +00:00
GDK_AVAILABLE_IN_3_2
Rename gtk_font_chooser_get_{family,face,size} ... to gtk_font_chooser_get_font_{family,face,size}, in order to avoid naming conflicts in bindings.
2011-09-11 22:17:58 +00:00
PangoFontFamily *gtk_font_chooser_get_font_family (GtkFontChooser *fontchooser);
gtk: Use versioned deprecations This patch changes all uses of GDK_DEPRECATED(_FOR) in gtk headers by the versioned variants, GDK_DEPRECATED_IN_3_x(_FOR). At the same time, we add GDK_AVAILABLE_IN_3_x annotations for all API additions in 3.2 and 3.4.
2012-02-27 12:10:59 +00:00
GDK_AVAILABLE_IN_3_2
Rename gtk_font_chooser_get_{family,face,size} ... to gtk_font_chooser_get_font_{family,face,size}, in order to avoid naming conflicts in bindings.
2011-09-11 22:17:58 +00:00
PangoFontFace *gtk_font_chooser_get_font_face (GtkFontChooser *fontchooser);
gtk: Use versioned deprecations This patch changes all uses of GDK_DEPRECATED(_FOR) in gtk headers by the versioned variants, GDK_DEPRECATED_IN_3_x(_FOR). At the same time, we add GDK_AVAILABLE_IN_3_x annotations for all API additions in 3.2 and 3.4.
2012-02-27 12:10:59 +00:00
GDK_AVAILABLE_IN_3_2
Rename gtk_font_chooser_get_{family,face,size} ... to gtk_font_chooser_get_font_{family,face,size}, in order to avoid naming conflicts in bindings.
2011-09-11 22:17:58 +00:00
gint gtk_font_chooser_get_font_size (GtkFontChooser *fontchooser);
Add GtkFontChooser:font-desc property Add a way to set/get the font as a PangoFontDescription.
2011-09-11 22:13:26 +00:00
gtk: Use versioned deprecations This patch changes all uses of GDK_DEPRECATED(_FOR) in gtk headers by the versioned variants, GDK_DEPRECATED_IN_3_x(_FOR). At the same time, we add GDK_AVAILABLE_IN_3_x annotations for all API additions in 3.2 and 3.4.
2012-02-27 12:10:59 +00:00
GDK_AVAILABLE_IN_3_2
Add GtkFontChooser:font-desc property Add a way to set/get the font as a PangoFontDescription.
2011-09-11 22:13:26 +00:00
PangoFontDescription *
gtk_font_chooser_get_font_desc (GtkFontChooser *fontchooser);
gtk: Use versioned deprecations This patch changes all uses of GDK_DEPRECATED(_FOR) in gtk headers by the versioned variants, GDK_DEPRECATED_IN_3_x(_FOR). At the same time, we add GDK_AVAILABLE_IN_3_x annotations for all API additions in 3.2 and 3.4.
2012-02-27 12:10:59 +00:00
GDK_AVAILABLE_IN_3_2
Add GtkFontChooser:font-desc property Add a way to set/get the font as a PangoFontDescription.
2011-09-11 22:13:26 +00:00
void gtk_font_chooser_set_font_desc (GtkFontChooser *fontchooser,
const PangoFontDescription *font_desc);
gtk: Use versioned deprecations This patch changes all uses of GDK_DEPRECATED(_FOR) in gtk headers by the versioned variants, GDK_DEPRECATED_IN_3_x(_FOR). At the same time, we add GDK_AVAILABLE_IN_3_x annotations for all API additions in 3.2 and 3.4.
2012-02-27 12:10:59 +00:00
GDK_AVAILABLE_IN_3_2
Rename GtkFontChooser:font-name to :font GtkFontButton already has a property named "font-name" which may conflict / be an ABI break when moving GtkFontButton to implement GtkFontChooser. Also, this is more in line with how other parts in gtk (e.g. GtkCellRendererText) call a font string property.
2011-09-05 11:26:49 +00:00
gchar* gtk_font_chooser_get_font (GtkFontChooser *fontchooser);
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
2011-09-11 23:49:26 +00:00
gtk: Use versioned deprecations This patch changes all uses of GDK_DEPRECATED(_FOR) in gtk headers by the versioned variants, GDK_DEPRECATED_IN_3_x(_FOR). At the same time, we add GDK_AVAILABLE_IN_3_x annotations for all API additions in 3.2 and 3.4.
2012-02-27 12:10:59 +00:00
GDK_AVAILABLE_IN_3_2
Setters should not return a boolean The setter for the "font" property returned a boolean that indicated whether the given font has been found. Instead, fall back to the default font name when the given font doesn't exist.
2011-09-05 20:45:44 +00:00
void gtk_font_chooser_set_font (GtkFontChooser *fontchooser,
Fix a parameter name mismatch
2011-09-13 18:57:21 +00:00
const gchar *fontname);
gtk: Use versioned deprecations This patch changes all uses of GDK_DEPRECATED(_FOR) in gtk headers by the versioned variants, GDK_DEPRECATED_IN_3_x(_FOR). At the same time, we add GDK_AVAILABLE_IN_3_x annotations for all API additions in 3.2 and 3.4.
2012-02-27 12:10:59 +00:00
GDK_AVAILABLE_IN_3_2
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
2011-09-11 23:49:26 +00:00
gchar* gtk_font_chooser_get_preview_text (GtkFontChooser *fontchooser);
gtk: Use versioned deprecations This patch changes all uses of GDK_DEPRECATED(_FOR) in gtk headers by the versioned variants, GDK_DEPRECATED_IN_3_x(_FOR). At the same time, we add GDK_AVAILABLE_IN_3_x annotations for all API additions in 3.2 and 3.4.
2012-02-27 12:10:59 +00:00
GDK_AVAILABLE_IN_3_2
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
2011-09-11 23:49:26 +00:00
void gtk_font_chooser_set_preview_text (GtkFontChooser *fontchooser,
const gchar *text);
gtk: Use versioned deprecations This patch changes all uses of GDK_DEPRECATED(_FOR) in gtk headers by the versioned variants, GDK_DEPRECATED_IN_3_x(_FOR). At the same time, we add GDK_AVAILABLE_IN_3_x annotations for all API additions in 3.2 and 3.4.
2012-02-27 12:10:59 +00:00
GDK_AVAILABLE_IN_3_2
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
2011-09-11 23:49:26 +00:00
gboolean gtk_font_chooser_get_show_preview_entry (GtkFontChooser *fontchooser);
gtk: Use versioned deprecations This patch changes all uses of GDK_DEPRECATED(_FOR) in gtk headers by the versioned variants, GDK_DEPRECATED_IN_3_x(_FOR). At the same time, we add GDK_AVAILABLE_IN_3_x annotations for all API additions in 3.2 and 3.4.
2012-02-27 12:10:59 +00:00
GDK_AVAILABLE_IN_3_2
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
2011-09-11 23:49:26 +00:00
void gtk_font_chooser_set_show_preview_entry (GtkFontChooser *fontchooser,
gboolean show_preview_entry);
gtk: Use versioned deprecations This patch changes all uses of GDK_DEPRECATED(_FOR) in gtk headers by the versioned variants, GDK_DEPRECATED_IN_3_x(_FOR). At the same time, we add GDK_AVAILABLE_IN_3_x annotations for all API additions in 3.2 and 3.4.
2012-02-27 12:10:59 +00:00
GDK_AVAILABLE_IN_3_2
Make GtkFontChooser an interface Make the GtkFontChooser API similar to the Gtk{File,Recent,App}Chooser APIs by introducing GtkFontChooser as an interface, that has a default implementation in GtkFontChooserWidget. https://bugzilla.gnome.org/show_bug.cgi?id=657627
2011-09-11 23:49:26 +00:00
void gtk_font_chooser_set_filter_func (GtkFontChooser *fontchooser,
GtkFontFilterFunc filter,
gpointer user_data,
GDestroyNotify destroy);
GtkFontChooser: Allow a custom font map This lets applications show their own fonts instead of or in addition to system fonts. https://bugzilla.gnome.org/show_bug.cgi?id=748771
2015-05-05 03:21:17 +00:00
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);
Add filtering to the font chooser
2011-08-15 02:20:00 +00:00
font chooser: Make the language property writable This is meant as an input to the font chooser. We don't want the user to select a language, but rather have fonts presented as they would work for the current language. Therefore, do away with the lang/script combo on the tweak page.
2018-04-02 17:34:22 +00:00
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);
font chooser: introduce font chooser levels This is a more systematic approach to reducing the level of detail in the font chooser.
2018-03-30 19:02:49 +00:00
GtkFontChooser: Missing G_END_DECLS in fontchooser header
2011-07-27 12:04:21 +00:00
G_END_DECLS
GtkFontChooser: Remove all cruft from the current GtkFontSelection implementation and start a new widget
2011-04-15 20:07:32 +00:00
GtkFontChooserDialog: Split the dialog out of gtkfontchooser.[ch] to gtkfontchooserdialog.[ch]
2011-05-11 20:52:39 +00:00
#endif /* __GTK_FONT_CHOOSER_H__ */
Reference in New Issue Copy Permalink