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

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

создаёт новый виджет содержащий указанный шрифт.

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

gtk_font_button_set_font_name ()

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

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

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

gtk_font_button_get_font_name ()

const gchar* gtk_font_button_get_font_name  (gtkfontbutton *font_button);

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

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

gtk_font_button_set_show_style ()

void        gtk_font_button_set_show_style  (gtkfontbutton *font_button,
                                             gboolean show_style);

если show_style это true, стиль шрифта будет отображён вместе с именем выбранного шрифта.

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

gtk_font_button_get_show_style ()

gboolean    gtk_font_button_get_show_style  (gtkfontbutton *font_button);

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

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

gtk_font_button_set_show_size ()

void        gtk_font_button_set_show_size   (gtkfontbutton *font_button,
                                             gboolean show_size);

если show_size true, размер шрифта отображается вместе с именем выбранного шрифта.

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

gtk_font_button_get_show_size ()

gboolean    gtk_font_button_get_show_size   (gtkfontbutton *font_button);

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

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

gtk_font_button_set_use_font ()

void        gtk_font_button_set_use_font    (gtkfontbutton *font_button,
                                             gboolean use_font);

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

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

gtk_font_button_get_use_font ()

gboolean    gtk_font_button_get_use_font    (gtkfontbutton *font_button);

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

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

gtk_font_button_set_use_size ()

void        gtk_font_button_set_use_size    (gtkfontbutton *font_button,
                                             gboolean use_size);

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

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

gtk_font_button_get_use_size ()

gboolean    gtk_font_button_get_use_size    (gtkfontbutton *font_button);

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

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

gtk_font_button_set_title ()

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

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

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

gtk_font_button_get_title ()

const gchar* gtk_font_button_get_title      (gtkfontbutton *font_button);

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

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

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

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

gtkfontselectiondialog, gtkcolorbutton.