GtkFontButton
GtkFontButton — Кнопка для запуска диалогового окна выбора шрифта
Функции
Свойства
Типы и значения
| struct | GtkFontButton |
Иерархия объектов
GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkButton ╰── GtkFontButton
Реализованные интерфейсы
GtkFontButton реализует AtkImplementorIface, GtkBuildable, GtkActionable, GtkActivatable и GtkFontChooser.
Файлы заголовков
#include <gtk/gtk.h>
Описание
Кнопка GtkFontButton отображает текущий выбранный шрифт и позволяет открыть диалоговое окно выбора шрифта для изменения шрифта. Подходит для выбора шрифта в диалоге настроек.
Элементы CSS
GtkFontButton имеет один элемент CSS с именем button и классом стиля .font.
Функции
gtk_font_button_new ()
GtkWidget *
gtk_font_button_new (void); Создаёт новый виджет выбора шрифта.
Возвращает
новый виджет выбора шрифта.
С: 2.4
gtk_font_button_new_with_font ()
GtkWidget *
gtk_font_button_new_with_font (const gchar *fontname); Создаёт новый виджет выбора шрифта.
Параметры
fontname | Имя шрифта, который будет отображаться в диалоге выбора шрифта |
Возвращает
новый виджет выбора шрифта.
С: 2.4
gtk_font_button_set_font_name ()
gboolean gtk_font_button_set_font_name (GtkFontButton *font_button,const gchar *fontname);
Устанавливает или обновляет текущий отображаемый шрифт в диалоге выбора шрифта.
Параметры
font_button | виджет GtkFontButton | |
fontname | Имя шрифта, который будет отображаться в диалоге выбора шрифта |
Возвращает
С: 2.4
gtk_font_button_get_font_name ()
const gchar *
gtk_font_button_get_font_name (GtkFontButton *font_button); Возвращает имя текущего выбранного шрифта. Это имя включает информацию о стиле и размере. Если вам нужно отобразить что-то этим шрифтом, используйте эту строку с pango_font_description_from_string() . Если вас интересуют определённые значения (название семейства, стиль, размер, вес), запросите их у объекта PangoFontDescription.
Параметры
font_button | виджет GtkFontButton |
Возвращает
внутреннюю копию имени шрифта, которую не нужно освобождать.
С: 2.4
gtk_font_button_set_show_style ()
void gtk_font_button_set_show_style (GtkFontButton *font_button,gboolean show_style);
Если show_style равно TRUE, стиль шрифта будет отображаться вместе с именем выбранного шрифта.
Параметры
font_button | виджет GtkFontButton | |
show_style |
|
С: 2.4
gtk_font_button_get_show_style ()
gboolean
gtk_font_button_get_show_style (GtkFontButton *font_button); Возвращает, будет ли отображаться название стиля шрифта в метке.
Параметры
font_button | виджет GtkFontButton |
Возвращает
будет ли отображаться стиль шрифта в метке.
С: 2.4
gtk_font_button_set_show_size ()
void gtk_font_button_set_show_size (GtkFontButton *font_button,gboolean show_size);
Если show_size равно TRUE, размер шрифта будет отображаться вместе с именем выбранного шрифта.
Параметры
font_button | виджет GtkFontButton | |
show_size |
|
С: 2.4
gtk_font_button_get_show_size ()
gboolean
gtk_font_button_get_show_size (GtkFontButton *font_button); Возвращает, будет ли отображаться размер шрифта в метке.
Параметры
font_button | виджет GtkFontButton |
Возвращает
будет ли отображаться размер шрифта в метке.
С: 2.4
gtk_font_button_set_use_font ()
void gtk_font_button_set_use_font (GtkFontButton *font_button,gboolean use_font);
Если use_font равно TRUE, имя шрифта будет выведено с помощью выбранного шрифта.
Параметры
font_button | виджет GtkFontButton | |
use_font | Если |
С: 2.4
gtk_font_button_get_use_font ()
gboolean
gtk_font_button_get_use_font (GtkFontButton *font_button); Возвращает, используется ли выбранный шрифт в метке.
Параметры
font_button | виджет GtkFontButton |
Возвращает
используется ли выбранный шрифт в метке.
С: 2.4
gtk_font_button_set_use_size ()
void gtk_font_button_set_use_size (GtkFontButton *font_button,gboolean use_size);
Если use_size равно TRUE, имя шрифта будет выведено с использованием выбранного размера.
Параметры
font_button | виджет GtkFontButton | |
use_size | Если |
С: 2.4
gtk_font_button_get_use_size ()
gboolean
gtk_font_button_get_use_size (GtkFontButton *font_button); Возвращает, используется ли выбранный размер в метке.
Параметры
font_button | виджет GtkFontButton |
Возвращает
используется ли выбранный размер в метке.
С: 2.4
gtk_font_button_set_title ()
void gtk_font_button_set_title (GtkFontButton *font_button,const gchar *title);
Устанавливает заголовок для диалога выбора шрифта.
Параметры
font_button | виджет GtkFontButton | |
title | строка, содержащая заголовок диалога выбора шрифта |
С: 2.4
gtk_font_button_get_title ()
const gchar *
gtk_font_button_get_title (GtkFontButton *font_button); Возвращает заголовок диалога выбора шрифта.
Параметры
font_button | виджет GtkFontButton |
Возвращает
внутреннюю копию строки заголовка, которую не нужно освобождать.
С: 2.4
Типы и значения
struct GtkFontButton
struct GtkFontButton;
Подробности свойств
Свойство “font-name”
“font-name” gchar *
Имя текущего выбранного шрифта.
Флаги: Чтение / Запись
Значение по умолчанию: "Sans 12"
С: 2.4
Свойство “show-size”
“show-size” gboolean
Если это свойство установлено в TRUE, размер выбранного шрифта будет отображаться в метке. Для более WYSIWYG отображения выбранного размера, см. свойство ::use-size.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С: 2.4
Свойство “show-style”
“show-style” gboolean
Если это свойство установлено в TRUE, имя выбранного стиля шрифта будет отображаться в метке. Для более WYSIWYG отображения выбранного стиля, см. свойство ::use-font.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С: 2.4
Свойство “title”
“title” gchar *
Заголовок диалогового окна выбора шрифта.
Флаги: Чтение / Запись
Значение по умолчанию: "Выбрать шрифт"
С: 2.4
Подробности сигналов
Сигнал “font-set”
void user_function (GtkFontButton *widget, gpointer user_data)
Сигнал ::font-set генерируется, когда пользователь выбирает шрифт. При обработке этого сигнала, используйте gtk_font_button_get_font_name(), чтобы узнать, какой шрифт был только что выбран.
Обратите внимание, что этот сигнал генерируется только при изменении пользователем шрифта. Если вам нужно реагировать и на программно изменённый шрифт, используйте сигнал notify::font-name.
Параметры
widget | объект, получивший сигнал. | |
user_data | данные пользователя, установленные при подключении обработчика сигналов. |
Флаги: Run First
С: 2.4
См. также
© 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/GtkFontButton.html