Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Implemented Interfaces  |  Properties

GtkFontSelection

GtkFontSelection Виджет для выбора шрифтов

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

#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.

Возвращает :

новый GtkFontSelection.


gtk_font_selection_get_font ()

GdkFont*    gtk_font_selection_get_font     (GtkFontSelection *fontsel);

Внимание

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

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

fontsel :

GtkFontSelection.

Возвращает :

Текущий выбранный шрифт, или NULL если нет выбранного шрифта.


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() если вы хотите сравнить два описания шрифта.

fontsel :

GtkFontSelection

Возвращает :

Строка с именем текущемго выбранного шрифта, или NULL если нет выбранного шрифта. Вы должны освободить эту строку с помощью g_free().


gtk_font_selection_set_font_name ()

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

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

fontsel :

GtkFontSelection

fontname :

Имя шрифта, например "Helvetica 12" или "Times Bold 18"

Возвращает :

TRUE если шрифт был полностью установлен; FALSE если шрифт не существует или если fontsel не принадлежит к определённому экрану.


gtk_font_selection_get_preview_text ()

const gchar* gtk_font_selection_get_preview_text (GtkFontSelection *fontsel);

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

fontsel :

GtkFontSelection.

Возвращает :

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


gtk_font_selection_set_preview_text ()

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

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

fontsel :

GtkFontSelection.

text :

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

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

Свойство "font"

  "font"                 GdkFont               : Read

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


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

  "font-name"            gchararray            : Read / Write

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

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


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

  "preview-text"         gchararray            : Read / Write

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

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

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

GtkFontSelectionDialog

Диалоговое окно которое использует GtkFontSelection.