Spec-Zone.ru › GTK 3.24

GtkFontButton

GtkFontButton — Кнопка для запуска диалогового окна выбора шрифтов

Функции

GtkWidget * gtk_font_button_new ()
GtkWidget * gtk_font_button_new_with_font ()
gboolean gtk_font_button_set_font_name ()
const gchar * gtk_font_button_get_font_name ()
void gtk_font_button_set_show_style ()
gboolean gtk_font_button_get_show_style ()
void gtk_font_button_set_show_size ()
gboolean gtk_font_button_get_show_size ()
void gtk_font_button_set_use_font ()
gboolean gtk_font_button_get_use_font ()
void gtk_font_button_set_use_size ()
gboolean gtk_font_button_get_use_size ()
void gtk_font_button_set_title ()
const gchar * gtk_font_button_get_title ()

Свойства

char * имя-шрифта Чтение / Запись
gboolean отображать-размер Чтение / Запись
gboolean отображать-стиль Чтение / Запись
char * заголовок Чтение / Запись
gboolean использовать-шрифт Чтение / Запись
gboolean использовать-размер Чтение / Запись

Сигналы

void шрифт-установлен Выполнять первым

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

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);

gtk_font_button_set_font_name устарел с версии 3.22 и не должен использоваться в новом коде.

Используйте gtk_font_chooser_set_font() вместо него

Устанавливает или обновляет текущий отображаемый шрифт в диалоге выбора шрифта.

Параметры

font_button

a GtkFontButton

fontname

Имя шрифта, который будет отображаться в диалоге выбора шрифта

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

TRUE

С версии: 2.4

gtk_font_button_get_font_name ()

const gchar *
gtk_font_button_get_font_name (GtkFontButton *font_button);

gtk_font_button_get_font_name устарел с версии 3.22 и не должен использоваться в новом коде.

Используйте gtk_font_chooser_get_font() вместо него

Возвращает имя текущего выбранного шрифта. Это имя включает в себя информацию о стиле и размере. Если нужно отобразить что-то этим шрифтом, используйте эту строку с pango_font_description_from_string(). Если вам нужно получить определённые значения (название семейства, стиль, размер, вес), просто запросите эти свойства у объекта PangoFontDescription.

Параметры

font_button

a 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

a GtkFontButton

show_style

TRUE если стиль шрифта должен быть отображён в метке.

С версии: 2.4

gtk_font_button_get_show_style ()

gboolean
gtk_font_button_get_show_style (GtkFontButton *font_button);

Возвращает, будет ли отображаться имя стиля шрифта в метке.

Параметры

font_button

a 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

a GtkFontButton

show_size

TRUE если размер шрифта должен быть отображён в диалоге.

С версии: 2.4

gtk_font_button_get_show_size ()

gboolean
gtk_font_button_get_show_size (GtkFontButton *font_button);

Возвращает, будет ли отображаться размер шрифта в метке.

Параметры

font_button

a 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

a GtkFontButton

use_font

Если TRUE, имя шрифта будет выведено с использованием выбранного шрифта.

С версии: 2.4

gtk_font_button_get_use_font ()

gboolean
gtk_font_button_get_use_font (GtkFontButton *font_button);

Возвращает, используется ли выбранный шрифт в метке.

Параметры

font_button

a 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

a GtkFontButton

use_size

Если TRUE, имя шрифта будет выведено с использованием выбранного размера.

С версии: 2.4

gtk_font_button_get_use_size ()

gboolean
gtk_font_button_get_use_size (GtkFontButton *font_button);

Возвращает, используется ли выбранный размер в метке.

Параметры

font_button

a GtkFontButton

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

используется ли выбранный размер в метке.

С версии: 2.4

gtk_font_button_set_title ()

void
gtk_font_button_set_title (GtkFontButton *font_button,
                           const gchar *title);

Устанавливает заголовок для диалога выбора шрифта.

Параметры

font_button

a GtkFontButton

title

строка, содержащая заголовок диалога выбора шрифта

С версии: 2.4

gtk_font_button_get_title ()

const gchar *
gtk_font_button_get_title (GtkFontButton *font_button);

Возвращает заголовок диалога выбора шрифта.

Параметры

font_button

a GtkFontButton

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

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

С версии: 2.4

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

struct GtkFontButton

struct GtkFontButton;

Подробное описание свойств

Свойство “font-name”

  “font-name”                char *

Имя текущего выбранного шрифта.

GtkFontButton:font-name устарело с версии 3.22 и не должно использоваться в новом коде.

Используйте свойство “font” вместо него.

Владелец: GtkFontButton

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

Значение по умолчанию: "Sans 12"

С версии: 2.4

Свойство “show-size”

  “show-size”                gboolean

Если это свойство установлено в TRUE, размер выбранного шрифта будет отображаться в метке. Для более визуального отображения выбранного размера, см. свойство ::use-size.

Владелец: GtkFontButton

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

Значение по умолчанию: TRUE

С версии: 2.4

Свойство “show-style”

  “show-style”               gboolean

Если это свойство установлено в TRUE, имя выбранного стиля шрифта будет отображаться в метке. Для более визуального отображения выбранного стиля, см. свойство ::use-font.

Владелец: GtkFontButton

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

Значение по умолчанию: TRUE

С версии: 2.4

Свойство “title”

  “title”                    char *

Заголовок диалогового окна выбора шрифта.

Владелец: GtkFontButton

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

Значение по умолчанию: "Выбрать шрифт"

С версии: 2.4

Свойство “use-font”

  “use-font”                 gboolean

Если это свойство установлено в TRUE, метка будет нарисована выбранным шрифтом.

Владелец: GtkFontButton

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

Значение по умолчанию: FALSE

С версии: 2.4

Свойство “use-size”

  “use-size”                 gboolean

Если это свойство установлено в TRUE, метка будет нарисована с выбранным размером шрифта.

Владелец: GtkFontButton

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

Значение по умолчанию: FALSE

С версии: 2.4

Подробное описание сигналов

Сигнал “font-set”

void
user_function (GtkFontButton *widget,
               gpointer       user_data)

Сигнал ::font-set генерируется, когда пользователь выбирает шрифт. При обработке этого сигнала используйте gtk_font_chooser_get_font(), чтобы узнать, какой шрифт был выбран.

Обратите внимание, что этот сигнал генерируется только при изменении шрифта пользователем. Если вам нужно реагировать и на программные изменения шрифта, используйте сигнал notify::font.

Параметры

widget

объект, который получил сигнал.

user_data

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

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

С версии: 2.4

См. также

GtkFontChooserDialog, GtkColorButton.

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkFontButton.html

Spec-Zone.ru

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