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

#include <gtk/gtk.h>

            gtkfontselection;
gtkwidget*  gtk_font_selection_new          (void);
gdkfont*    gtk_font_selection_get_font     (gtkfontselection *fontsel);

gchar*      gtk_font_selection_get_font_name
                                            (gtkfontselection *fontsel);
gboolean    gtk_font_selection_set_font_name
                                            (gtkfontselection *fontsel,
                                             const gchar *fontname);
const gchar* gtk_font_selection_get_preview_text

                                            (gtkfontselection *fontsel);
void        gtk_font_selection_set_preview_text
                                            (gtkfontselection *fontsel,
                                             const gchar *text);

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

  gobject
   +----ginitiallyunowned
         +----gtkobject
               +----gtkwidget

                     +----gtkcontainer
                           +----gtkbox
                                 +----gtkvbox
                                       +----gtkfontselection

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

gtkfontselection реализует atkimplementoriface.

свойства

  "font"                 gdkfont               : read
  "font-name"            gchararray            : read / write
  "preview-text"         gchararray            : read / write

описание

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

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

для получения выбранного шрифта используйте gtk_font_selection_get_font_name().

для изменения текста отображаемого в области предварительного просмотра шрифта, используйте gtk_font_selection_set_preview_text().

детали

gtkfontselection

typedef struct _gtkfontselection gtkfontselection;

структура gtkfontselection содержит только закрытые данные, доступ к которым обеспечивают функции описанные ниже.

gtk_font_selection_new ()

gtkwidget*  gtk_font_selection_new          (void);

создаёт новый gtkfontselection.

gtk_font_selection_get_font ()

gdkfont*    gtk_font_selection_get_font     (gtkfontselection *fontsel);

внимание

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

получает текущий выбранный шрифт.

gtk_font_selection_get_font_name ()

gchar*      gtk_font_selection_get_font_name
                                            (gtkfontselection *fontsel);

получает имя текущемго выбранного шрифта. помните, это может быть не та строка которую вы установили с помощью gtk_font_selection_set_font_name(), так как виджет выбора шрифта может нормализовать имена шрифтов и поэтому возвращаемая строка отличается структурой. например, "helvetica italic bold 12" может быть нормализована в "helvetica bold italic 12". используйте pango_font_description_equal() если вы хотите сравнить два описания шрифта.

gtk_font_selection_set_font_name ()

gboolean    gtk_font_selection_set_font_name
                                            (gtkfontselection *fontsel,
                                             const gchar *fontname);

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

gtk_font_selection_get_preview_text ()

const gchar* gtk_font_selection_get_preview_text
                                            (gtkfontselection *fontsel);

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

gtk_font_selection_set_preview_text ()

void        gtk_font_selection_set_preview_text
                                            (gtkfontselection *fontsel,
                                             const gchar *text);

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

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

свойство "font"

  "font"                 gdkfont               : read

gdkfont который выбран в текущий момент.

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

  "font-name"            gchararray            : read / write

x строка представляющая этот шрифт.

значение по умолчанию: null

свойство "preview-text"

  "preview-text"         gchararray            : read / write

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

значение по умолчанию: "abcdefghijk abcdefghijk"

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