GTK+ Reference Manual |
||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
GtkFontSelectionGtkFontSelection Виджет для выбора шрифтов |
#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()
.
typedef struct _GtkFontSelection GtkFontSelection;Структура GtkFontSelection содержит только закрытые данные, доступ к которым обеспечивают функции описанные ниже.
gtk_font_selection_new ()
GtkWidget* gtk_font_selection_new (void);Создаёт новый GtkFontSelection.
Возвращает : |
новый GtkFontSelection. |
GdkFont* gtk_font_selection_get_font (GtkFontSelection *fontsel);Внимание
gtk_font_selection_get_font
устарела и не должна использоваться при написании нового кода.Получает текущий выбранный шрифт.
|
|
Возвращает : |
Текущий выбранный шрифт, или NULL если нет выбранного шрифта. |
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()
если вы хотите сравнить два описания
шрифта.
|
|
Возвращает : |
Строка с именем текущемго выбранного
шрифта, или NULL
если нет выбранного шрифта. Вы должны
освободить эту строку с помощью
|
gboolean gtk_font_selection_set_font_name
(GtkFontSelection *fontsel,
const gchar *fontname);
Устанавливает текущий выбранный шрифт.
Помните, fontsel
должен знать
экран в котором он работает; в этом можно
убедиться просто создав fontsel
внутри окна верхнего уровня перед
вызовом этой функции.
|
|
|
Имя шрифта, например "Helvetica 12" или "Times Bold 18" |
Возвращает : |
TRUE
если шрифт был полностью установлен;
FALSE
если шрифт не существует или если
|
const gchar* gtk_font_selection_get_preview_text
(GtkFontSelection *fontsel);
Определяет текст отображаемый в области предварительного просмотра шрифта.
|
|
Возвращает : |
Текст отображаемый в области предварительного просмотра. Этой строкой владеет виджет и её не нужно изменять или освобождать. |
void gtk_font_selection_set_preview_text
(GtkFontSelection *fontsel,
const gchar *text);
Устанавливает текст отображаемый в области предварительного просмотра.
|
|
|
Текст отображаемый в области предварительного просмотра. |
font
""font" GdkFont : ReadGdkFont который выбран в текущий момент.
Свойство "
font-name
""font-name" gchararray : Read / WriteX строка представляющая этот шрифт.
Значение по умолчанию: NULL
Свойство "
preview-text
""preview-text" gchararray : Read / WriteТекст отображаемый для демонстрации выбранного шрифта.
Значение по умолчанию: "abcdefghijk ABCDEFGHIJK"
Смотрите также
Диалоговое окно которое использует GtkFontSelection. |