Spec-Zone.ru › GTK 3.24

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 ()

Свойства

char * имя_шрифта Чтение / Запись
char * текст_предварительного_просмотра Чтение / Запись

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

структура 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

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

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

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

Владелец: GtkFontSelection

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

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

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

  “preview-text”             char *

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

Владелец: GtkFontSelection

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

Значение по умолчанию: "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.24/GtkFontSelection.html

Spec-Zone.ru

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