Spec-Zone.ru › GTK 3.22

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

Свойства

gchar * font-name Чтение / Запись
gboolean show-size Чтение / Запись
gboolean show-style Чтение / Запись
gchar * title Чтение / Запись
gboolean use-font Чтение / Запись
gboolean use-size Чтение / Запись

Сигналы

void font-set Run First

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

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

Создает новый виджет выбора шрифта.

Returns

новый виджет выбора шрифта.

Since: 2.4

gtk_font_button_new_with_font ()

GtkWidget *
gtk_font_button_new_with_font (const gchar *fontname);

Создает новый виджет выбора шрифта.

Parameters

fontname

Имя шрифта для отображения в диалоговом окне выбора шрифта

Returns

новый виджет выбора шрифта.

Since: 2.4

gtk_font_button_set_font_name ()

gboolean
gtk_font_button_set_font_name (GtkFontButton *font_button,
                               const gchar *fontname);

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

Parameters

font_button

a GtkFontButton

fontname

Имя шрифта для отображения в диалоговом окне выбора шрифта

Returns

TRUE

Since: 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.

Parameters

font_button

a GtkFontButton

Returns

внутренняя копия имени шрифта, которую не нужно освобождать.

Since: 2.4

gtk_font_button_set_show_style ()

void
gtk_font_button_set_show_style (GtkFontButton *font_button,
                                gboolean show_style);

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

Parameters

font_button

a GtkFontButton

show_style

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

Since: 2.4

gtk_font_button_get_show_style ()

gboolean
gtk_font_button_get_show_style (GtkFontButton *font_button);

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

Parameters

font_button

a GtkFontButton

Returns

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

Since: 2.4

gtk_font_button_set_show_size ()

void
gtk_font_button_set_show_size (GtkFontButton *font_button,
                               gboolean show_size);

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

Parameters

font_button

a GtkFontButton

show_size

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

Since: 2.4

gtk_font_button_get_show_size ()

gboolean
gtk_font_button_get_show_size (GtkFontButton *font_button);

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

Parameters

font_button

a GtkFontButton

Returns

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

Since: 2.4

gtk_font_button_set_use_font ()

void
gtk_font_button_set_use_font (GtkFontButton *font_button,
                              gboolean use_font);

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

Parameters

font_button

a GtkFontButton

use_font

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

Since: 2.4

gtk_font_button_get_use_font ()

gboolean
gtk_font_button_get_use_font (GtkFontButton *font_button);

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

Parameters

font_button

a GtkFontButton

Returns

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

Since: 2.4

gtk_font_button_set_use_size ()

void
gtk_font_button_set_use_size (GtkFontButton *font_button,
                              gboolean use_size);

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

Parameters

font_button

a GtkFontButton

use_size

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

Since: 2.4

gtk_font_button_get_use_size ()

gboolean
gtk_font_button_get_use_size (GtkFontButton *font_button);

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

Parameters

font_button

a GtkFontButton

Returns

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

Since: 2.4

gtk_font_button_set_title ()

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

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

Parameters

font_button

a GtkFontButton

title

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

Since: 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”                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

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

  “use-font”                 gboolean

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

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

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

С версии: 2.4

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

  “use-size”                 gboolean

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

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

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

С версии: 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

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

Флаги: Выполнение вначале

С версии: 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.22/GtkFontButton.html

Spec-Zone.ru

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