Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Implemented Interfaces  |  Properties  |  Signals

GtkFontButton

GtkFontButton Кнопка переключающая шрифт в диалоге выбора

Краткое описание

#include <gtk/gtk.h> GtkFontButton; GtkWidget* gtk_font_button_new (void); GtkWidget* gtk_font_button_new_with_font (const gchar *fontname); gboolean gtk_font_button_set_font_name (GtkFontButton *font_button, const gchar *fontname); const gchar* gtk_font_button_get_font_name (GtkFontButton *font_button); void gtk_font_button_set_show_style (GtkFontButton *font_button, gboolean show_style); gboolean gtk_font_button_get_show_style (GtkFontButton *font_button); void gtk_font_button_set_show_size (GtkFontButton *font_button, gboolean show_size); gboolean gtk_font_button_get_show_size (GtkFontButton *font_button); void gtk_font_button_set_use_font (GtkFontButton *font_button, gboolean use_font); gboolean gtk_font_button_get_use_font (GtkFontButton *font_button); void gtk_font_button_set_use_size (GtkFontButton *font_button, gboolean use_size); gboolean gtk_font_button_get_use_size (GtkFontButton *font_button); void gtk_font_button_set_title (GtkFontButton *font_button, const gchar *title); const gchar* gtk_font_button_get_title (GtkFontButton *font_button);

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

GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkButton +----GtkFontButton

Реализуемые интерфейсы

GtkFontButton реализует AtkImplementorIface.

Свойства

"font-name" gchararray : Read / Write "show-size" gboolean : Read / Write "show-style" gboolean : Read / Write "title" gchararray : Read / Write "use-font" gboolean : Read / Write "use-size" gboolean : Read / Write

Сигналы

"font-set" void user_function (GtkFontButton *widget, gpointer user_data) : Run first

Описание

GtkFontButton это кнопка отображающая текущий выбранный шрифт и позволяющая запустить диалог для его изменения. Это удобный виджет для выбора шрифта в диалогах параметров.

Детали

GtkFontButton

typedef struct _GtkFontButton GtkFontButton;

Структура GtkFontButton содержит только закрытые данные к которым нет непосредственного доступа.


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 :

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

Возвращает :

Возвращаемое значение функцией gtk_font_selection_dialog_set_font_name() если диалог выбора шрифта существует, иначе FALSE.

Начиная с версии 2.4


gtk_font_button_get_font_name ()

const gchar* gtk_font_button_get_font_name  (GtkFontButton *font_button);

Определяет имя текущемго выбранного шрифта.

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 :

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

Начиная с версии 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 :

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

Начиная с версии 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 :

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

Начиная с версии 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 :

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

Начиная с версии 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

Детали свойств

Свойство "font-name"

  "font-name"            gchararray            : Read / Write

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

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

Начиная с версии 2.4


Свойство "show-size"

  "show-size"            gboolean              : Read / Write

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

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

Начиная с версии 2.4


Свойство "show-style"

  "show-style"           gboolean              : Read / Write

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

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

Начиная с версии 2.4


Свойство "title"

  "title"                gchararray            : Read / Write

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

Значение по умолчанию: "Pick a Font"

Начиная с версии 2.4


Свойство "use-font"

  "use-font"             gboolean              : Read / Write

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

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

Начиная с версии 2.4


Свойство "use-size"

  "use-size"             gboolean              : Read / Write

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

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

Начиная с версии 2.4

Детали сигнала

Сигнал "font-set"

void user_function (GtkFontButton *widget, gpointer user_data) : Run first

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

Помните, что этот сигнал издаётся только когда пользователь меняет шрифт. Если вам нужна реакция на программное изменение шрифта, используйте сигнал notify::font-name.

widget :

Объект получающий сигнал.

user_data :

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

Начиная с версии 2.4

Смотрите также

GtkFontSelectionDialog, GtkColorButton.