GtkFontChooser
GtkFontChooser — Интерфейс, реализуемый виджетами, отображающими шрифты
Функции
Свойства
| gchar * | font | Чтение / Запись |
| PangoFontDescription * | font-desc | Чтение / Запись |
| gchar * | preview-text | Чтение / Запись |
| gboolean | show-preview-entry | Чтение / Запись |
Сигналы
| void | font-activated | Run First |
Типы и значения
Иерархия объектов
GInterface ╰── GtkFontChooser
Предварительные условия
GtkFontChooser требует GObject.
Известные реализации
GtkFontChooser реализуется с помощью GtkFontButton, GtkFontChooserDialog и GtkFontChooserWidget.
Включения
#include <gtk/gtk.h>
Описание
GtkFontChooser — это интерфейс, который могут реализовывать виджеты, отображающие список шрифтов. В GTK+ основными объектами, реализующими этот интерфейс, являются GtkFontChooserWidget, GtkFontChooserDialog и GtkFontButton. Интерфейс GtkFontChooser был введен в GTK+ 3.2.
Функции
gtk_font_chooser_get_font_family ()
PangoFontFamily *
gtk_font_chooser_get_font_family (GtkFontChooser *fontchooser); Получает PangoFontFamily, представляющий выбранное семейство шрифтов. Семейства шрифтов — это набор шрифтовых начертаний.
Если выбранный шрифт не установлен, возвращает NULL.
Параметры
fontchooser |
Возвращает
PangoFontFamily, представляющий выбранное семейство шрифтов, или NULL. Возвращаемый объект принадлежит fontchooser и не должен быть изменён или освобождён.
[nullable][transfer none]
С: 3.2
gtk_font_chooser_get_font_face ()
PangoFontFace *
gtk_font_chooser_get_font_face (GtkFontChooser *fontchooser); Получает PangoFontFace, представляющий подробности выбранной группы шрифтов (т.е. семейство, наклон, вес, ширина и т. д.).
Если выбранный шрифт не установлен, возвращает NULL.
Параметры
fontchooser |
Возвращает
PangoFontFace, представляющий подробности выбранной группы шрифтов, или NULL. Возвращаемый объект принадлежит fontchooser и не должен быть изменён или освобождён.
[nullable][transfer none]
С: 3.2
gtk_font_chooser_get_font_size ()
gint
gtk_font_chooser_get_font_size (GtkFontChooser *fontchooser); Размер выбранного шрифта.
Параметры
fontchooser |
Возвращает
Целое число, представляющее размер выбранного шрифта, или -1, если размер шрифта не выбран.
С: 3.2
gtk_font_chooser_get_font ()
gchar *
gtk_font_chooser_get_font (GtkFontChooser *fontchooser); Получает имя текущего выбранного шрифта.
Обратите внимание, что это может быть другая строка, чем та, которую вы задали с помощью gtk_font_chooser_set_font(), так как виджет выбора шрифта может нормализовать имена шрифтов и, следовательно, вернуть строку с другой структурой. Например, “Helvetica Italic Bold 12” может быть нормализован до “Helvetica Bold Italic 12”.
Используйте pango_font_description_equal(), если вы хотите сравнить два описания шрифтов.
Параметры
fontchooser |
Возвращает
Строку с именем текущего шрифта или NULL, если шрифт не выбран. Вы должны освободить эту строку с помощью g_free().
[nullable][transfer full]
С: 3.2
gtk_font_chooser_set_font ()
void gtk_font_chooser_set_font (GtkFontChooser *fontchooser,const gchar *fontname);
Устанавливает текущий выбранный шрифт.
Параметры
fontchooser | ||
fontname | имя шрифта, например, “Helvetica 12” или “Times Bold 18” |
С: 3.2
gtk_font_chooser_get_font_desc ()
PangoFontDescription *
gtk_font_chooser_get_font_desc (GtkFontChooser *fontchooser); Получает текущий выбранный шрифт.
Обратите внимание, что это может быть другая строка, чем та, которую вы задали с помощью gtk_font_chooser_set_font(), так как виджет выбора шрифта может нормализовать имена шрифтов и, следовательно, вернуть строку с другой структурой. Например, “Helvetica Italic Bold 12” может быть нормализован до “Helvetica Bold Italic 12”.
Используйте pango_font_description_equal(), если вы хотите сравнить два описания шрифтов.
Параметры
fontchooser |
Возвращает
PangoFontDescription текущего шрифта или NULL, если шрифт не выбран.
[nullable][transfer full]
С: 3.2
gtk_font_chooser_set_font_desc ()
void gtk_font_chooser_set_font_desc (GtkFontChooser *fontchooser,const PangoFontDescription *font_desc);
Устанавливает текущий выбранный шрифт из font_desc.
Параметры
fontchooser | ||
font_desc |
С: 3.2
gtk_font_chooser_get_preview_text ()
gchar *
gtk_font_chooser_get_preview_text (GtkFontChooser *fontchooser); Получает текст, отображаемый в области предварительного просмотра.
Параметры
fontchooser |
Возвращает
отображаемый в области предварительного просмотра текст.
[transfer full]
С: 3.2
gtk_font_chooser_set_preview_text ()
void gtk_font_chooser_set_preview_text (GtkFontChooser *fontchooser,const gchar *text);
Устанавливает текст, отображаемый в области предварительного просмотра. text используется для отображения внешнего вида выбранного шрифта.
Параметры
fontchooser | ||
text | текст для отображения в области предварительного просмотра. | [transfer none] |
С: 3.2
gtk_font_chooser_get_show_preview_entry ()
gboolean
gtk_font_chooser_get_show_preview_entry
(GtkFontChooser *fontchooser); Возвращает, отображается ли область предварительного просмотра или нет.
Параметры
fontchooser |
Возвращаемое значение
TRUE, если область предварительного просмотра отображается, или FALSE, если она скрыта.
С: 3.2
gtk_font_chooser_set_show_preview_entry ()
void gtk_font_chooser_set_show_preview_entry (GtkFontChooser *fontchooser,gboolean show_preview_entry);
Отображает или скрывает редактируемую область предварительного просмотра.
Параметры
fontchooser | ||
show_preview_entry | отображать или нет редактируемую область предварительного просмотра |
С: 3.2
GtkFontFilterFunc ()
gboolean (*GtkFontFilterFunc) (const PangoFontFamily *family,const PangoFontFace *face,gpointer data);
Тип функции, используемой для определения отображаемых шрифтов в GtkFontChooser. См. gtk_font_chooser_set_filter_func().
Параметры
family | ||
face | a PangoFontFace, принадлежащий | |
data | переданные пользователем данные | [closure] |
Возвращаемое значение
TRUE, если шрифт должен отображаться
gtk_font_chooser_set_filter_func ()
void gtk_font_chooser_set_filter_func (GtkFontChooser *fontchooser,GtkFontFilterFunc filter,gpointer user_data,GDestroyNotify destroy);
Добавляет функцию фильтрации, определяющую, какие шрифты отображать в диалоговом окне выбора шрифта.
Параметры
fontchooser | ||
filter | a GtkFontFilterFunc, или | [allow-none] |
user_data | данные для передачи в | |
destroy | функция для освобождения |
С: 3.2
gtk_font_chooser_set_font_map ()
void gtk_font_chooser_set_font_map (GtkFontChooser *fontchooser,PangoFontMap *fontmap);
Устанавливает пользовательскую карту шрифтов для использования в этом элементе выбора шрифтов. Пользовательская карта шрифтов может использоваться для представления шрифтов, специфичных для приложения, вместо или в дополнение к обычным системным шрифтам.
Обратите внимание, что другие виджеты GTK+ смогут использовать шрифт, специфичный для приложения, только если он присутствует в используемой ими карте шрифтов:
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);
Параметры
fontchooser | ||
fontmap | a PangoFontMap. | [allow-none] |
С: 3.18
gtk_font_chooser_get_font_map ()
PangoFontMap *
gtk_font_chooser_get_font_map (GtkFontChooser *fontchooser); Получает пользовательскую карту шрифтов этого виджета выбора шрифтов или NULL, если её нет.
Параметры
fontchooser |
С: 3.18
Типы и значения
GtkFontChooser
typedef struct _GtkFontChooser GtkFontChooser;
Подробности свойств
Свойство “font”
“font” gchar *
Описание шрифта в виде строки, например, "Sans Italic 12".
Флаги: Чтение / Запись
Значение по умолчанию: "Sans 10"
Свойство “font-desc”
“font-desc” PangoFontDescription *
Описание шрифта как PangoFontDescription.
Флаги: Чтение / Запись
Свойство “preview-text”
“preview-text” gchar *
Строка для предварительного просмотра шрифта.
Флаги: Чтение / Запись
Значение по умолчанию: "The quick brown fox jumps over the lazy dog."
Свойство “show-preview-entry”
“show-preview-entry” gboolean
Отображать ли поле для изменения текста предварительного просмотра.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
Подробности о сигналах
Сигнал “font-activated”
void user_function (GtkFontChooser *self, gchar *fontname, gpointer user_data)
Издаётся, когда шрифт активирован. Обычно это происходит, когда пользователь дважды щелкает элемент, или элемент выбран, и пользователь нажимает одну из клавиш Пробел, Shift+Пробел, Возврат или Enter.
Параметры
self | объект, получивший сигнал | |
fontname | имя шрифта | |
user_data | данные пользователя, установленные при подключении обработчика сигналов. |
Флаги: Выполнить сначала
См. также
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.20/GtkFontChooser.html