Spec-Zone.ru › GTK 3.22

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 * font-name Чтение / Запись
gchar * preview-text Чтение / Запись

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

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, который перечисляет все стили, доступные для выбранного шрифта. Например, “Regular”, “Bold” и т. д.

Параметры

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

объект 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

объект 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

объект 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

объект 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

объект 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.22/GtkFontSelection.html

Spec-Zone.ru

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