Spec-Zone.ru › GTK 3.22

GtkFontChooser

GtkFontChooser — Интерфейс, реализуемый виджетами, отображающими шрифты

Функции

PangoFontFamily * gtk_font_chooser_get_font_family ()
PangoFontFace * gtk_font_chooser_get_font_face ()
gint gtk_font_chooser_get_font_size ()
gchar * gtk_font_chooser_get_font ()
void gtk_font_chooser_set_font ()
PangoFontDescription * gtk_font_chooser_get_font_desc ()
void gtk_font_chooser_set_font_desc ()
gchar * gtk_font_chooser_get_preview_text ()
void gtk_font_chooser_set_preview_text ()
gboolean gtk_font_chooser_get_show_preview_entry ()
void gtk_font_chooser_set_show_preview_entry ()
gboolean (*GtkFontFilterFunc) ()
void gtk_font_chooser_set_filter_func ()
void gtk_font_chooser_set_font_map ()
PangoFontMap * gtk_font_chooser_get_font_map ()

Свойства

gchar * font Чтение / Запись
PangoFontDescription * font-desc Чтение / Запись
gchar * preview-text Чтение / Запись
gboolean show-preview-entry Чтение / Запись

Сигналы

void font-activated Run First

Типы и значения

GtkFontChooser

Иерархия объектов

    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

PangoFontFamily

face

PangoFontFace принадлежащий family

data

пользовательские данные, передаваемые в gtk_font_chooser_set_filter_func().

[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, или NULL.

[allow-none]

user_data

данные для передачи в filter

destroy

функция, вызываемая для освобождения data, когда она больше не нужна

С: 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

PangoFontMap.

[allow-none]

С: 3.18

gtk_font_chooser_get_font_map ()

PangoFontMap *
gtk_font_chooser_get_font_map (GtkFontChooser *fontchooser);

Получает пользовательскую карту шрифтов этого виджета выбора шрифтов или NULL, если таковой нет.

Параметры

fontchooser

объект GtkFontChooser

Возвращаемое значение

PangoFontMap или NULL.

[nullable][transfer full]

С: 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

данные пользователя, установленные при подключении обработчика сигналов.

Флаги: Выполнить сначала

См. также

GtkFontChooserDialog, GtkFontChooserWidget, GtkFontButton

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API