The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

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.






Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру