Spec-Zone.ru › GTK 3.20

GtkFontSelection

GtkFontSelection — Устаревший виджет для выбора шрифтов

Функции

GtkWidget * gtk_font_selection_new ()
gchar * gtk_font_selection_get_font_name ()
gboolean gtk_font_selection_set_font_name ()
const gchar * gtk_font_selection_get_preview_text ()
void gtk_font_selection_set_preview_text ()
PangoFontFace * gtk_font_selection_get_face ()
GtkWidget * gtk_font_selection_get_face_list ()
PangoFontFamily * gtk_font_selection_get_family ()
gint gtk_font_selection_get_size ()
GtkWidget * gtk_font_selection_get_family_list ()
GtkWidget * gtk_font_selection_get_preview_entry ()
GtkWidget * gtk_font_selection_get_size_entry ()
GtkWidget * gtk_font_selection_get_size_list ()

Свойства

gchar * имя-шрифта Чтение / Запись
gchar * текст-превью Чтение / Запись

Типы и значения

struct GtkFontSelection

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBox
                    ╰── GtkFontSelection

Реализованные интерфейсы

GtkFontSelection реализует AtkImplementorIface, GtkBuildable и GtkOrientable.

Файлы заголовков

#include <gtk/gtk.h>

Описание

Виджет GtkFontSelection отображает список доступных шрифтов, стилей и размеров, позволяя пользователю выбрать шрифт. Он используется в виджете GtkFontSelectionDialog для создания диалогового окна выбора шрифтов.

Для установки выбранного по умолчанию шрифта, используйте gtk_font_selection_set_font_name().

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

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

В GTK+ 3.2, виджет GtkFontSelection устарел в пользу виджета GtkFontChooser.

Функции

gtk_font_selection_new ()

GtkWidget *
gtk_font_selection_new (void);

gtk_font_selection_new устарела начиная с версии 3.2 и не должна использоваться в новом коде.

Используйте GtkFontChooserWidget вместо этого

Создаёт новый GtkFontSelection.

Возвращаемое значение

новый GtkFontSelection

gtk_font_selection_get_font_name ()

gchar *
gtk_font_selection_get_font_name (GtkFontSelection *fontsel);

gtk_font_selection_get_font_name устарела начиная с версии 3.2 и не должна использоваться в новом коде.

Используйте GtkFontChooser

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

Обратите внимание, что это может быть другая строка, чем та, которую вы задали с помощью gtk_font_selection_set_font_name(), так как виджет выбора шрифтов может нормализовать имена шрифтов и, таким образом, вернуть строку с другой структурой. Например, “Helvetica Italic Bold 12” может быть нормализован до “Helvetica Bold Italic 12”. Используйте pango_font_description_equal(), если вы хотите сравнить два описания шрифтов.

Параметры

fontsel

a GtkFontSelection

Возвращаемое значение

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

gtk_font_selection_set_font_name ()

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

gtk_font_selection_set_font_name устарела начиная с версии 3.2 и не должна использоваться в новом коде.

Используйте GtkFontChooser

Устанавливает текущий выбранный шрифт.

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

Параметры

fontsel

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

gtk_font_selection_get_preview_text устарела начиная с версии 3.2 и не должна использоваться в новом коде.

Используйте GtkFontChooser

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

Параметры

fontsel

a GtkFontSelection

Возвращаемое значение

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

gtk_font-selection-set-preview-text ()

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

gtk_font_selection_set_preview_text устарела начиная с версии 3.2 и не должна использоваться в новом коде.

Используйте GtkFontChooser

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

Параметры

fontsel

a GtkFontSelection

text

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

gtk_font_selection_get_face ()

PangoFontFace *
gtk_font_selection_get_face (GtkFontSelection *fontsel);

gtk_font_selection_get_face устарела начиная с версии 3.2 и не должна использоваться в новом коде.

Используйте GtkFontChooser

Получает PangoFontFace, представляющий детали выбранной группы шрифтов (то есть семейство, наклон, вес, ширина и т. д.).

Параметры

fontsel

a GtkFontSelection

Возвращаемое значение

PangoFontFace, представляющий детали выбранной группы шрифтов. Возвращённый объект принадлежит fontsel и не должен изменяться или освобождаться.

[transfer none]

С: 2.14

gtk_font_selection_get_face_list ()

GtkWidget *
gtk_font_selection_get_face_list (GtkFontSelection *fontsel);

gtk_font_selection_get_face_list устарела начиная с версии 3.2 и не должна использоваться в новом коде.

Используйте GtkFontChooser

Возвращает GtkTreeView, который перечисляет все стили, доступные для выбранного шрифта. Например, “Обычный”, “Жирный” и т. д.

Параметры

fontsel

a GtkFontSelection

Возвращаемое значение

GtkWidget, являющаяся частью fontsel .

[transfer none]

С: 2.14

gtk_font-selection-get-family ()

PangoFontFamily *
gtk_font_selection_get_family (GtkFontSelection *fontsel);

gtk_font_selection_get_family устарела начиная с версии 3.2 и не должна использоваться в новом коде.

Используйте GtkFontChooser

Получает PangoFontFamily, представляющий выбранное семейство шрифтов.

Параметры

fontsel

a GtkFontSelection

Возвращаемое значение

PangoFontFamily, представляющий выбранное семейство шрифтов. Семейства шрифтов — это набор шрифтовых начертаний. Возвращённый объект принадлежит fontsel и не должен изменяться или освобождаться.

[transfer none]

С: 2.14

gtk_font_selection_get_size ()

gint
gtk_font_selection_get_size (GtkFontSelection *fontsel);

gtk_font_selection_get_size устарел с версии 3.2 и не должен использоваться в новых кодах.

Используйте GtkFontChooser

Размер выбранного шрифта.

Параметры

fontsel

a GtkFontSelection

Возвращаемое значение

Целое число, представляющее размер выбранного шрифта, или -1, если размер шрифта не выбран.

С: 2.14

gtk_font_selection_get_family_list ()

GtkWidget *
gtk_font_selection_get_family_list (GtkFontSelection *fontsel);

gtk_font_selection_get_family_list устарел с версии 3.2 и не должен использоваться в новых кодах.

Используйте GtkFontChooser

Возвращает GtkTreeView, который перечисляет начертания шрифтов, например, “Sans”, “Serif” и т. д.

Параметры

fontsel

a GtkFontSelection

Возвращаемое значение

GtkWidget, который является частью fontsel .

[transfer none]

С: 2.14

gtk_font_selection_get_preview_entry ()

GtkWidget *
gtk_font_selection_get_preview_entry (GtkFontSelection *fontsel);

gtk_font_selection_get_preview_entry устарел с версии 3.2 и не должен использоваться в новых кодах.

Используйте GtkFontChooser

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

Параметры

fontsel

a GtkFontSelection

Возвращаемое значение

GtkWidget, который является частью fontsel .

[transfer none]

С: 2.14

gtk_font-selection_get_size_entry ()

GtkWidget *
gtk_font_selection_get_size_entry (GtkFontSelection *fontsel);

gtk_font_selection_get_size_entry устарел с версии 3.2 и не должен использоваться в новых кодах.

Используйте GtkFontChooser

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

Параметры

fontsel

a GtkFontSelection

Возвращаемое значение

GtkWidget, который является частью fontsel .

[transfer none]

С: 2.14

gtk_font-selection_get_size_list ()

GtkWidget *
gtk_font_selection_get_size_list (GtkFontSelection *fontsel);

gtk_font_selection_get_size_list устарел с версии 3.2 и не должен использоваться в новых кодах.

Используйте GtkFontChooser

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

Параметры

fontsel

a GtkFontSelection

Возвращаемое значение

GtkWidget, который является частью fontsel .

[transfer none]

С: 2.14

Типы и значения

struct GtkFontSelection

struct GtkFontSelection;

Подробное описание свойств

Свойство “font-name”

  “font-name”                gchar *

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

Флаги: Чтение/Запись

Значение по умолчанию: "Sans 10"

Свойство “preview-text”

  “preview-text”             gchar *

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

Флаги: Чтение/Запись

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

См. также

GtkFontSelectionDialog, GtkFontChooser

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.20/GtkFontSelection.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API