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 | объект GtkFontChooser |
Возвращает
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 | объект GtkFontChooser |
Возвращает
PangoFontFace, представляющий выбранный шрифт, или NULL. Возвращённый объект принадлежит fontchooser и не должен быть изменён или освобождён.
[nullable][transfer none]
С: 3.2
gtk_font_chooser_get_font_size ()
gint
gtk_font_chooser_get_font_size (GtkFontChooser *fontchooser); Размер выбранного шрифта.
Параметры
fontchooser | объект GtkFontChooser |
Возвращает
Целое число, представляющее размер выбранного шрифта, или -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 | объект GtkFontChooser |
Возвращает
Строка с именем текущего шрифта или 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 | объект GtkFontChooser | |
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 | объект GtkFontChooser |
Возвращает
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 | объект GtkFontChooser | |
font_desc | объект PangoFontDescription |
С: 3.2
gtk_font_chooser_get_preview_text ()
gchar *
gtk_font_chooser_get_preview_text (GtkFontChooser *fontchooser); Получает текст, отображаемый в области предварительного просмотра.
Параметры
fontchooser | объект GtkFontChooser |
Возвращает
текст, отображаемый в области предварительного просмотра.
[transfer full]
С: 3.2
gtk_font_chooser_set_preview_text ()
void gtk_font_chooser_set_preview_text (GtkFontChooser *fontchooser,const gchar *text);
Устанавливает текст, отображаемый в области предварительного просмотра. text используется для отображения того, как выбранный шрифт выглядит.
Параметры
fontchooser | объект GtkFontChooser | |
text | текст для отображения в области предварительного просмотра. | [transfer none] |
С: 3.2
gtk_font_chooser_get_show_preview_entry ()
gboolean
gtk_font_chooser_get_show_preview_entry
(GtkFontChooser *fontchooser); Возвращает, отображается ли поле предварительного просмотра.
Параметры
fontchooser | объект GtkFontChooser |
Возвращаемое значение
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 | объект GtkFontChooser | |
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 | 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 | объект GtkFontChooser | |
filter | функция 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 | объект GtkFontChooser | |
fontmap | [allow-none] |
С: 3.18
gtk_font_chooser_get_font_map ()
PangoFontMap *
gtk_font_chooser_get_font_map (GtkFontChooser *fontchooser); Получает пользовательскую карту шрифтов этого виджета выбора шрифтов или NULL, если таковой нет.
Параметры
fontchooser | объект GtkFontChooser |
С: 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 *
Строка для предварительного просмотра шрифта.
Флаги: Чтение/Запись
Значение по умолчанию: "Быстрый рыжий лис перепрыгивает через ленивую собаку."
Свойство “show-preview-entry”
“show-preview-entry” gboolean
Отображать ли поле для изменения текста предварительного просмотра.
Флаги: Чтение/Запись
Значение по умолчанию: TRUE
Подробное описание сигналов
Сигнал “font-activated”
void user_function (GtkFontChooser *self, gchar *fontname, gpointer user_data)
Используется при активации шрифта. Обычно это происходит при двойном щелчке элемента, или при выборе элемента и нажатии пользователем клавиш Пробел, Shift+Пробел, Возврат или Ввод.
Параметры
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.22/GtkFontChooser.html