Learning_GTK4_tree/gtk/deprecated/gtkfontchooser.c

657 lines
20 KiB
C

/* GTK - The GIMP Toolkit
* gtkfontchooser.c - Abstract interface for font file selectors GUIs
*
* 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
* 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 <http://www.gnu.org/licenses/>.
*/
#include "config.h"
#include "gtkfontchooser.h"
#include "gtkfontchooserprivate.h"
#include "gtktypebuiltins.h"
#include "gtkprivate.h"
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
/**
* GtkFontChooser:
*
* `GtkFontChooser` is an interface that can be implemented by widgets
* for choosing fonts.
*
* In GTK, the main objects that implement this interface are
* [class@Gtk.FontChooserWidget], [class@Gtk.FontChooserDialog] and
* [class@Gtk.FontButton].
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
enum
{
SIGNAL_FONT_ACTIVATED,
LAST_SIGNAL
};
static guint chooser_signals[LAST_SIGNAL];
typedef GtkFontChooserIface GtkFontChooserInterface;
G_DEFINE_INTERFACE (GtkFontChooser, gtk_font_chooser, G_TYPE_OBJECT);
static void
gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
{
/**
* GtkFontChooser:font: (attributes org.gtk.Property.get=gtk_font_chooser_get_font org.gtk.Property.set=gtk_font_chooser_set_font)
*
* The font description as a string, e.g. "Sans Italic 12".
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/
g_object_interface_install_property
(iface,
g_param_spec_string ("font", NULL, NULL,
GTK_FONT_CHOOSER_DEFAULT_FONT_NAME,
GTK_PARAM_READWRITE));
/**
* GtkFontChooser:font-desc: (attributes org.gtk.Property.get=gtk_font_chooser_get_font_desc org.gtk.Property.set=gtk_font_chooser_set_font_desc)
*
* The font description as a `PangoFontDescription`.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/
g_object_interface_install_property
(iface,
g_param_spec_boxed ("font-desc", NULL, NULL,
PANGO_TYPE_FONT_DESCRIPTION,
GTK_PARAM_READWRITE));
/**
* GtkFontChooser:preview-text: (attributes org.gtk.Property.get=gtk_font_chooser_get_preview_text org.gtk.Property.set=gtk_font_chooser_set_preview_text)
*
* The string with which to preview the font.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/
g_object_interface_install_property
(iface,
g_param_spec_string ("preview-text", NULL, NULL,
pango_language_get_sample_string (NULL),
GTK_PARAM_READWRITE));
/**
* GtkFontChooser:show-preview-entry: (attributes org.gtk.Property.get=gtk_font_chooser_get_show_preview_entry org.gtk.Property.set=gtk_font_chooser_set_show_preview_entry)
*
* Whether to show an entry to change the preview text.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/
g_object_interface_install_property
(iface,
g_param_spec_boolean ("show-preview-entry", NULL, NULL,
TRUE,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
/**
* GtkFontChooser:level: (attributes org.gtk.Property.get=gtk_font_chooser_get_level org.gtk.Property.set=gtk_font_chooser_set_level)
*
* The level of granularity to offer for selecting fonts.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/
g_object_interface_install_property
(iface,
g_param_spec_flags ("level", NULL, NULL,
GTK_TYPE_FONT_CHOOSER_LEVEL,
GTK_FONT_CHOOSER_LEVEL_FAMILY |
GTK_FONT_CHOOSER_LEVEL_STYLE |
GTK_FONT_CHOOSER_LEVEL_SIZE,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
/**
* GtkFontChooser:font-features: (attributes org.gtk.Property.get=gtk_font_chooser_get_font_features)
*
* The selected font features.
*
* The format of the string is compatible with
* CSS and with Pango attributes.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/
g_object_interface_install_property
(iface,
g_param_spec_string ("font-features", NULL, NULL,
"",
GTK_PARAM_READABLE));
/**
* GtkFontChooser:language: (attributes org.gtk.Property.get=gtk_font_chooser_get_language org.gtk.Property.set=gtk_font_chooser_set_language)
*
* The language for which the font features were selected.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/
g_object_interface_install_property
(iface,
g_param_spec_string ("language", NULL, NULL,
"",
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
/**
* GtkFontChooser::font-activated:
* @self: the object which received the signal
* @fontname: the font name
*
* Emitted when a font is activated.
*
* This usually happens when the user double clicks an item,
* or an item is selected and the user presses one of the keys
* Space, Shift+Space, Return or Enter.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/
chooser_signals[SIGNAL_FONT_ACTIVATED] =
g_signal_new (I_("font-activated"),
GTK_TYPE_FONT_CHOOSER,
G_SIGNAL_RUN_FIRST,
G_STRUCT_OFFSET (GtkFontChooserIface, font_activated),
NULL, NULL,
NULL,
G_TYPE_NONE,
1, G_TYPE_STRING);
}
/**
* gtk_font_chooser_get_font_family:
* @fontchooser: a `GtkFontChooser`
*
* Gets the `PangoFontFamily` representing the selected font family.
*
* Font families are a collection of font faces.
*
* If the selected font is not installed, returns %NULL.
*
* Returns: (nullable) (transfer none): A `PangoFontFamily` representing the
* selected font family
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
PangoFontFamily *
gtk_font_chooser_get_font_family (GtkFontChooser *fontchooser)
{
g_return_val_if_fail (GTK_IS_FONT_CHOOSER (fontchooser), NULL);
return GTK_FONT_CHOOSER_GET_IFACE (fontchooser)->get_font_family (fontchooser);
}
/**
* gtk_font_chooser_get_font_face:
* @fontchooser: a `GtkFontChooser`
*
* Gets the `PangoFontFace` representing the selected font group
* details (i.e. family, slant, weight, width, etc).
*
* If the selected font is not installed, returns %NULL.
*
* Returns: (nullable) (transfer none): A `PangoFontFace` representing the
* selected font group details
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
PangoFontFace *
gtk_font_chooser_get_font_face (GtkFontChooser *fontchooser)
{
g_return_val_if_fail (GTK_IS_FONT_CHOOSER (fontchooser), NULL);
return GTK_FONT_CHOOSER_GET_IFACE (fontchooser)->get_font_face (fontchooser);
}
/**
* gtk_font_chooser_get_font_size:
* @fontchooser: a `GtkFontChooser`
*
* The selected font size.
*
* Returns: A n integer representing the selected font size,
* or -1 if no font size is selected.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
int
gtk_font_chooser_get_font_size (GtkFontChooser *fontchooser)
{
g_return_val_if_fail (GTK_IS_FONT_CHOOSER (fontchooser), -1);
return GTK_FONT_CHOOSER_GET_IFACE (fontchooser)->get_font_size (fontchooser);
}
/**
* gtk_font_chooser_get_font: (attributes org.gtk.Method.get_property=font)
* @fontchooser: a `GtkFontChooser`
*
* Gets the currently-selected font name.
*
* Note that this can be a different string than what you set with
* [method@Gtk.FontChooser.set_font], as the font chooser widget may
* normalize font names and thus return a string with a different
* structure. For example, “Helvetica Italic Bold 12” could be
* normalized to “Helvetica Bold Italic 12”.
*
* Use [method@Pango.FontDescription.equal] if you want to compare two
* font descriptions.
*
* Returns: (nullable) (transfer full): A string with the name
* of the current font
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
char *
gtk_font_chooser_get_font (GtkFontChooser *fontchooser)
{
char *fontname;
g_return_val_if_fail (GTK_IS_FONT_CHOOSER (fontchooser), NULL);
g_object_get (fontchooser, "font", &fontname, NULL);
return fontname;
}
/**
* gtk_font_chooser_set_font: (attributes org.gtk.Method.set_property=font)
* @fontchooser: a `GtkFontChooser`
* @fontname: a font name like “Helvetica 12” or “Times Bold 18”
*
* Sets the currently-selected font.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
void
gtk_font_chooser_set_font (GtkFontChooser *fontchooser,
const char *fontname)
{
g_return_if_fail (GTK_IS_FONT_CHOOSER (fontchooser));
g_return_if_fail (fontname != NULL);
g_object_set (fontchooser, "font", fontname, NULL);
}
/**
* gtk_font_chooser_get_font_desc: (attributes org.gtk.Method.get_property=font-desc)
* @fontchooser: a `GtkFontChooser`
*
* Gets the currently-selected font.
*
* Note that this can be a different string than what you set with
* [method@Gtk.FontChooser.set_font], as the font chooser widget may
* normalize font names and thus return a string with a different
* structure. For example, “Helvetica Italic Bold 12” could be
* normalized to “Helvetica Bold Italic 12”.
*
* Use [method@Pango.FontDescription.equal] if you want to compare two
* font descriptions.
*
* Returns: (nullable) (transfer full): A `PangoFontDescription` for the
* current font
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
PangoFontDescription *
gtk_font_chooser_get_font_desc (GtkFontChooser *fontchooser)
{
PangoFontDescription *font_desc;
g_return_val_if_fail (GTK_IS_FONT_CHOOSER (fontchooser), NULL);
g_object_get (fontchooser, "font-desc", &font_desc, NULL);
return font_desc;
}
/**
* gtk_font_chooser_set_font_desc: (attributes org.gtk.Method.set_property=font-desc)
* @fontchooser: a `GtkFontChooser`
* @font_desc: a `PangoFontDescription`
*
* Sets the currently-selected font from @font_desc.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
void
gtk_font_chooser_set_font_desc (GtkFontChooser *fontchooser,
const PangoFontDescription *font_desc)
{
g_return_if_fail (GTK_IS_FONT_CHOOSER (fontchooser));
g_return_if_fail (font_desc != NULL);
g_object_set (fontchooser, "font-desc", font_desc, NULL);
}
/**
* gtk_font_chooser_get_preview_text: (attributes org.gtk.Method.get_property=preview-text)
* @fontchooser: a `GtkFontChooser`
*
* Gets the text displayed in the preview area.
*
* Returns: (transfer full): the text displayed in the preview area
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
char *
gtk_font_chooser_get_preview_text (GtkFontChooser *fontchooser)
{
char *text;
g_return_val_if_fail (GTK_IS_FONT_CHOOSER (fontchooser), NULL);
g_object_get (fontchooser, "preview-text", &text, NULL);
return text;
}
/**
* gtk_font_chooser_set_preview_text: (attributes org.gtk.Method.set_property=preview-text)
* @fontchooser: a `GtkFontChooser`
* @text: (transfer none): the text to display in the preview area
*
* Sets the text displayed in the preview area.
*
* The @text is used to show how the selected font looks.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
void
gtk_font_chooser_set_preview_text (GtkFontChooser *fontchooser,
const char *text)
{
g_return_if_fail (GTK_IS_FONT_CHOOSER (fontchooser));
g_return_if_fail (text != NULL);
g_object_set (fontchooser, "preview-text", text, NULL);
}
/**
* gtk_font_chooser_get_show_preview_entry: (attributes org.gtk.Method.get_property=show-preview-entry)
* @fontchooser: a `GtkFontChooser`
*
* Returns whether the preview entry is shown or not.
*
* Returns: %TRUE if the preview entry is shown or %FALSE if it is hidden.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
gboolean
gtk_font_chooser_get_show_preview_entry (GtkFontChooser *fontchooser)
{
gboolean show;
g_return_val_if_fail (GTK_IS_FONT_CHOOSER (fontchooser), FALSE);
g_object_get (fontchooser, "show-preview-entry", &show, NULL);
return show;
}
/**
* gtk_font_chooser_set_show_preview_entry: (attributes org.gtk.Method.set_property=show-preview-entry)
* @fontchooser: a `GtkFontChooser`
* @show_preview_entry: whether to show the editable preview entry or not
*
* Shows or hides the editable preview entry.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
void
gtk_font_chooser_set_show_preview_entry (GtkFontChooser *fontchooser,
gboolean show_preview_entry)
{
g_return_if_fail (GTK_IS_FONT_CHOOSER (fontchooser));
show_preview_entry = show_preview_entry != FALSE;
g_object_set (fontchooser, "show-preview-entry", show_preview_entry, NULL);
}
/**
* gtk_font_chooser_set_filter_func:
* @fontchooser: a `GtkFontChooser`
* @filter: (nullable): a `GtkFontFilterFunc`
* @user_data: (closure): data to pass to @filter
* @destroy: function to call to free @data when it is no longer needed
*
* Adds a filter function that decides which fonts to display
* in the font chooser.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
void
gtk_font_chooser_set_filter_func (GtkFontChooser *fontchooser,
GtkFontFilterFunc filter,
gpointer user_data,
GDestroyNotify destroy)
{
g_return_if_fail (GTK_IS_FONT_CHOOSER (fontchooser));
GTK_FONT_CHOOSER_GET_IFACE (fontchooser)->set_filter_func (fontchooser,
filter,
user_data,
destroy);
}
void
_gtk_font_chooser_font_activated (GtkFontChooser *chooser,
const char *fontname)
{
g_return_if_fail (GTK_IS_FONT_CHOOSER (chooser));
g_signal_emit (chooser, chooser_signals[SIGNAL_FONT_ACTIVATED], 0, fontname);
}
/**
* gtk_font_chooser_set_font_map:
* @fontchooser: a `GtkFontChooser`
* @fontmap: (nullable): a `PangoFontMap`
*
* Sets a custom font map to use for this font chooser widget.
*
* A custom font map can be used to present application-specific
* fonts instead of or in addition to the normal system fonts.
*
* ```c
* FcConfig *config;
* PangoFontMap *fontmap;
*
* config = FcInitLoadConfigAndFonts ();
* FcConfigAppFontAddFile (config, my_app_font_file);
*
* fontmap = pango_cairo_font_map_new_for_font_type (CAIRO_FONT_TYPE_FT);
* pango_fc_font_map_set_config (PANGO_FC_FONT_MAP (fontmap), config);
*
* gtk_font_chooser_set_font_map (font_chooser, fontmap);
* ```
*
* Note that other GTK widgets will only be able to use the
* application-specific font if it is present in the font map they use:
*
* ```c
* context = gtk_widget_get_pango_context (label);
* pango_context_set_font_map (context, fontmap);
* ```
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
void
gtk_font_chooser_set_font_map (GtkFontChooser *fontchooser,
PangoFontMap *fontmap)
{
g_return_if_fail (GTK_IS_FONT_CHOOSER (fontchooser));
g_return_if_fail (fontmap == NULL || PANGO_IS_FONT_MAP (fontmap));
if (GTK_FONT_CHOOSER_GET_IFACE (fontchooser)->set_font_map)
GTK_FONT_CHOOSER_GET_IFACE (fontchooser)->set_font_map (fontchooser, fontmap);
}
/**
* gtk_font_chooser_get_font_map:
* @fontchooser: a `GtkFontChooser`
*
* Gets the custom font map of this font chooser widget,
* or %NULL if it does not have one.
*
* Returns: (nullable) (transfer full): a `PangoFontMap`
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
PangoFontMap *
gtk_font_chooser_get_font_map (GtkFontChooser *fontchooser)
{
PangoFontMap *fontmap = NULL;
g_return_val_if_fail (GTK_IS_FONT_CHOOSER (fontchooser), NULL);
if (GTK_FONT_CHOOSER_GET_IFACE (fontchooser)->get_font_map)
fontmap = GTK_FONT_CHOOSER_GET_IFACE (fontchooser)->get_font_map (fontchooser);
return fontmap;
}
/**
* gtk_font_chooser_set_level: (attributes org.gtk.Method.set_property=level)
* @fontchooser: a `GtkFontChooser`
* @level: the desired level of granularity
*
* Sets the desired level of granularity for selecting fonts.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
void
gtk_font_chooser_set_level (GtkFontChooser *fontchooser,
GtkFontChooserLevel level)
{
g_return_if_fail (GTK_IS_FONT_CHOOSER (fontchooser));
g_object_set (fontchooser, "level", level, NULL);
}
/**
* gtk_font_chooser_get_level: (attributes org.gtk.Method.get_property=level)
* @fontchooser: a `GtkFontChooser`
*
* Returns the current level of granularity for selecting fonts.
*
* Returns: the current granularity level
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
GtkFontChooserLevel
gtk_font_chooser_get_level (GtkFontChooser *fontchooser)
{
GtkFontChooserLevel level;
g_return_val_if_fail (GTK_IS_FONT_CHOOSER (fontchooser), 0);
g_object_get (fontchooser, "level", &level, NULL);
return level;
}
/**
* gtk_font_chooser_get_font_features: (attributes org.gtk.Method.get_property=font-features)
* @fontchooser: a `GtkFontChooser`
*
* Gets the currently-selected font features.
*
* The format of the returned string is compatible with the
* [CSS font-feature-settings property](https://www.w3.org/TR/css-fonts-4/#font-rend-desc).
* It can be passed to [func@Pango.AttrFontFeatures.new].
*
* Returns: the currently selected font features
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
char *
gtk_font_chooser_get_font_features (GtkFontChooser *fontchooser)
{
char *text;
g_return_val_if_fail (GTK_IS_FONT_CHOOSER (fontchooser), NULL);
g_object_get (fontchooser, "font-features", &text, NULL);
return text;
}
/**
* gtk_font_chooser_get_language: (attributes org.gtk.Method.get_property=language)
* @fontchooser: a `GtkFontChooser`
*
* Gets the language that is used for font features.
*
* Returns: the currently selected language
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
char *
gtk_font_chooser_get_language (GtkFontChooser *fontchooser)
{
char *text;
g_return_val_if_fail (GTK_IS_FONT_CHOOSER (fontchooser), NULL);
g_object_get (fontchooser, "language", &text, NULL);
return text;
}
/**
* gtk_font_chooser_set_language: (attributes org.gtk.Method.set_property=language)
* @fontchooser: a `GtkFontChooser`
* @language: a language
*
* Sets the language to use for font features.
*
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead
*/
void
gtk_font_chooser_set_language (GtkFontChooser *fontchooser,
const char *language)
{
g_return_if_fail (GTK_IS_FONT_CHOOSER (fontchooser));
g_object_set (fontchooser, "language", language, NULL);
}