Spec-Zone.ru › GTK 3.20

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

a 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

a 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

a 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

a 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

a 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

a 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

a GtkFontChooser

font_desc

a PangoFontDescription

С: 3.2

gtk_font_chooser_get_preview_text ()

gchar *
gtk_font_chooser_get_preview_text (GtkFontChooser *fontchooser);

Получает текст, отображаемый в области предварительного просмотра.

Параметры

fontchooser

a 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

a GtkFontChooser

text

текст для отображения в области предварительного просмотра.

[transfer none]

С: 3.2

gtk_font_chooser_get_show_preview_entry ()

gboolean
gtk_font_chooser_get_show_preview_entry
                               (GtkFontChooser *fontchooser);

Возвращает, отображается ли область предварительного просмотра или нет.

Параметры

fontchooser

a 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

a 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

a PangoFontFamily

face

a 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

a GtkFontChooser

filter

a 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

a GtkFontChooser

fontmap

a PangoFontMap.

[allow-none]

С: 3.18

gtk_font_chooser_get_font_map ()

PangoFontMap *
gtk_font_chooser_get_font_map (GtkFontChooser *fontchooser);

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

Параметры

fontchooser

a GtkFontChooser

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

a 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 *

Строка для предварительного просмотра шрифта.

Флаги: Чтение / Запись

Значение по умолчанию: "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

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

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

См. также

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.20/GtkFontChooser.html

Spec-Zone.ru

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