GtkTextTag

struct GtkTextTag

struct GtkTextTag;

struct GtkTextAttributes

struct GtkTextAttributes {
  GtkTextAppearance appearance;

  GtkJustification justification;
  GtkTextDirection direction;

  PangoFontDescription *font;

  gdouble font_scale;

  gint left_margin;
  gint right_margin;
  gint indent;

  gint pixels_above_lines;
  gint pixels_below_lines;
  gint pixels_inside_wrap;

  PangoTabArray *tabs;

  GtkWrapMode wrap_mode;

  PangoLanguage *language;

  guint invisible : 1;
  guint bg_full_height : 1;
  guint editable : 1;
  guint no_fallback: 1;

  gint letter_spacing;

#ifdef __GI_SCANNER__
  /* The scanner should only see the transparent union, so that its
   * content does not vary across architectures.
   */
  union {
    gchar *font_features;
};

Использование GtkTextAttributes напрямую требуется редко. Оно полезно в основном с gtk_text_iter_get_attributes(). Как и в большинстве структур GTK+, поля в этой структуре должны только читаться, но никогда не изменяться напрямую.

struct GtkTextAppearance

struct GtkTextAppearance {
  GdkColor bg_color; /* pixel is taken for underline color */
  GdkColor fg_color; /* pixel is taken for strikethrough color */

  /* super/subscript rise, can be negative */
  gint rise;

  guint underline : 4;          /* PangoUnderline */
  guint strikethrough : 1;

  /* Whether to use background-related values; this is irrelevant for
   * the values struct when in a tag, but is used for the composite
   * values struct; it's true if any of the tags being composited
   * had background stuff set.
   */
  guint draw_bg : 1;

  /* These are only used when we are actually laying out and rendering
   * a paragraph; not when a GtkTextAppearance is part of a
   * GtkTextAttributes.
   */
  guint inside_selection : 1;
  guint is_text : 1;

  /* For the sad story of this bit of code, see
   * https://bugzilla.gnome.org/show_bug.cgi?id=711158
   */
#ifdef __GI_SCANNER__
  /* The scanner should only see the transparent union, so that its
   * content does not vary across architectures.
   */
  union {
    GdkRGBA *rgba[2];
};

Свойство “accumulative-margin”

  “accumulative-margin”      gboolean

Указывает, накапливаются поля или перекрывают друг друга.

Если установлено в TRUE, поля этого тега добавляются к полям любых других ненакапливающихся полей. Если установлено в FALSE, поля перекрывают друг друга (значение по умолчанию).

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

Значение по умолчанию: FALSE

С версии: 2.12

Свойство “background”

  “background”               gchar *

Цвет фона в виде строки.

Флаги: Запись

Значение по умолчанию: NULL

Свойство “background-full-height”

  “background-full-height”   gboolean

Заполняет ли цвет фона всю высоту строки или только высоту помеченных символов.

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

Значение по умолчанию: FALSE

Свойство “background-full-height-set”

  “background-full-height-set” gboolean

Влияет ли этот тег на высоту фона.

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

Значение по умолчанию: FALSE

Свойство “background-gdk”

  “background-gdk”           GdkColor *

Цвет фона как GdkColor.

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

Свойство “background-rgba”

  “background-rgba”          GdkRGBA *

Цвет фона как GdkRGBA.

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

С версии: 3.2

Свойство “background-set”

  “background-set”           gboolean

Влияет ли этот тег на цвет фона.

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

Значение по умолчанию: FALSE

Свойство “direction”

  “direction”                GtkTextDirection

Направление текста, например, справа налево или слева направо.

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

Значение по умолчанию: GTK_TEXT_DIR_NONE

Свойство “editable”

  “editable”                 gboolean

Можно ли изменять текст пользователем.

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

Значение по умолчанию: TRUE

Свойство “editable-set”

  “editable-set”             gboolean

Влияет ли этот тег на возможность редактирования текста.

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

Значение по умолчанию: FALSE

Свойство “fallback”

  “fallback”                 gboolean

Включена ли подстановка шрифтов.

Если установлено в TRUE, другие шрифты будут подставлены там, где текущий шрифт не содержит глифов.

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

Значение по умолчанию: TRUE

С версии: 3.16

Свойство “fallback-set”

  “fallback-set”             gboolean

Влияет ли этот тег на подстановку шрифтов.

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

Значение по умолчанию: FALSE

Свойство “family”

  “family”                   gchar *

Название семейства шрифтов, например, Sans, Helvetica, Times, Monospace.

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

Значение по умолчанию: NULL

Свойство “family-set”

  “family-set”               gboolean

Влияет ли этот тег на семейство шрифтов.

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

Значение по умолчанию: FALSE

Свойство “font”

  “font”                     gchar *

Описание шрифта в виде строки, например, \"Sans Italic 12\".

Обратите внимание, что начальное значение этого свойства зависит от внутренней работы PangoFontDescription.

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

Значение по умолчанию: NULL

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

  “font-desc”                PangoFontDescription *

Описание шрифта как структура PangoFontDescription.

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

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

  “font-features”            gchar *

Функции шрифта OpenType в виде строки.

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

Значение по умолчанию: NULL

С версии: 3.18

Свойство “font-features-set”

  “font-features-set”        gboolean

Влияет ли этот тег на функции шрифта.

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

Значение по умолчанию: FALSE

Свойство “foreground”

  “foreground”               gchar *

Цвет переднего плана в виде строки.

Флаги: Запись

Значение по умолчанию: NULL

Свойство “foreground-gdk”

  “foreground-gdk”           GdkColor *

Цвет переднего плана как GdkColor.

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

Свойство “foreground-rgba”

  “foreground-rgba”          GdkRGBA *

Цвет переднего плана как GdkRGBA.

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

С версии: 3.2

Свойство “foreground-set”

  “foreground-set”           gboolean

Влияет ли этот тег на цвет переднего плана.

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

Значение по умолчанию: FALSE

Свойство “indent”

  “indent”                   gint

Величина отступа абзаца в пикселях.

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

Значение по умолчанию: 0

Свойство “indent-set”

  “indent-set”               gboolean

Влияет ли этот тег на отступ.

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

Значение по умолчанию: FALSE

Свойство “invisible”

  “invisible”                gboolean

Скрыт ли этот текст.

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

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

Значение по умолчанию: FALSE

С версии: 2.8

Свойство “invisible-set”

  “invisible-set”            gboolean

Влияет ли этот тег на видимость текста.

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

Значение по умолчанию: FALSE

Свойство “justification”

  “justification”            GtkJustification

Выравнивание по левому, правому или центру.

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

Значение по умолчанию: GTK_JUSTIFY_LEFT

Свойство “justification-set”

  “justification-set”        gboolean

Влияет ли этот тег на выравнивание абзаца.

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

Значение по умолчанию: FALSE

Свойство “language”

  “language”                 gchar *

Язык этого текста в виде кода ISO. Pango может использовать это как подсказку при рендеринге текста. Если не задано, будет использовано соответствующее значение по умолчанию.

Обратите внимание, что начальное значение этого свойства зависит от текущей локали, см. также gtk_get_default_language().

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

Значение по умолчанию: NULL

Свойство “language-set”

  “language-set”             gboolean

Влияет ли этот тег на язык, на котором отображается текст.

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

Значение по умолчанию: FALSE

Свойство “left-margin”

  “left-margin”              gint

Ширина левого поля в пикселях.

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

Допустимые значения: >= 0

Значение по умолчанию: 0

Свойство “left-margin-set”

  “left-margin-set”          gboolean

Влияет ли этот тег на левое поле.

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

Значение по умолчанию: FALSE

Свойство “letter-spacing”

  “letter-spacing”           gint

Дополнительное расстояние между графемами в единицах Pango.

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

Допустимые значения: >= 0

Значение по умолчанию: 0

С версии: 3.16

Свойство “letter-spacing-set”

  “letter-spacing-set”       gboolean

Влияет ли этот тег на интервал между буквами.

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

Значение по умолчанию: FALSE

Свойство “name”

  “name”                     gchar *

Имя, используемое для ссылки на тег текста. NULL для анонимных тегов.

Флаги: Чтение / Запись / Только для конструктора

Значение по умолчанию: NULL

Свойство “paragraph-background”

  “paragraph-background”     gchar *

Цвет фона абзаца в виде строки.

Флаги: Запись

Значение по умолчанию: NULL

С версии: 2.8

Свойство “paragraph-background-gdk”

  “paragraph-background-gdk” GdkColor *

Цвет фона абзаца в виде GdkColor.

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

С: 2.8

Свойство “paragraph-background-rgba”

  “paragraph-background-rgba” GdkRGBA *

Цвет фона абзаца в виде GdkRGBA.

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

С: 3.2

Свойство “paragraph-background-set”

  “paragraph-background-set” gboolean

Определяет, влияет ли этот тег на цвет фона абзаца.

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

Значение по умолчанию: FALSE

Свойство “pixels-above-lines”

  “pixels-above-lines”       gint

Пиксели пустого пространства над абзацами.

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

Допустимые значения: >= 0

Значение по умолчанию: 0

Свойство “pixels-above-lines-set”

  “pixels-above-lines-set”   gboolean

Определяет, влияет ли этот тег на количество пикселей над строками.

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

Значение по умолчанию: FALSE

Свойство “pixels-below-lines”

  “pixels-below-lines”       gint

Пиксели пустого пространства под абзацами.

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

Допустимые значения: >= 0

Значение по умолчанию: 0

Свойство “pixels-below-lines-set”

  “pixels-below-lines-set”   gboolean

Определяет, влияет ли этот тег на количество пикселей над строками.

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

Значение по умолчанию: FALSE

Свойство “pixels-inside-wrap”

  “pixels-inside-wrap”       gint

Пиксели пустого пространства между переносимыми строками в абзаце.

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

Допустимые значения: >= 0

Значение по умолчанию: 0

Свойство “pixels-inside-wrap-set”

  “pixels-inside-wrap-set”   gboolean

Определяет, влияет ли этот тег на количество пикселей между переносимыми строками.

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

Значение по умолчанию: FALSE

Свойство “right-margin”

  “right-margin”             gint

Ширина правого отступа в пикселях.

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

Допустимые значения: >= 0

Значение по умолчанию: 0

Свойство “right-margin-set”

  “right-margin-set”         gboolean

Определяет, влияет ли этот тег на правый отступ.

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

Значение по умолчанию: FALSE

Свойство “rise”

  “rise”                     gint

Смещение текста над базовой линией (ниже базовой линии, если rise отрицательный) в единицах Pango.

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

Значение по умолчанию: 0

Свойство “rise-set”

  “rise-set”                 gboolean

Определяет, влияет ли этот тег на смещение rise.

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

Значение по умолчанию: FALSE

Свойство “scale”

  “scale”                    gdouble

Размер шрифта как коэффициент масштабирования относительно размера шрифта по умолчанию. Это правильно адаптируется к изменениям темы и т. д., поэтому рекомендуется. Pango предопределяет некоторые масштабы, такие как PANGO_SCALE_X_LARGE.

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

Допустимые значения: >= 0

Значение по умолчанию: 1

Свойство “scale-set”

  “scale-set”                gboolean

Определяет, масштабирует ли этот тег размер шрифта на определенный коэффициент.

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

Значение по умолчанию: FALSE

Свойство “size”

  “size”                     gint

Размер шрифта в единицах Pango.

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

Допустимые значения: >= 0

Значение по умолчанию: 0

Свойство “size-points”

  “size-points”              gdouble

Размер шрифта в пунктах.

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

Допустимые значения: >= 0

Значение по умолчанию: 0

Свойство “size-set”

  “size-set”                 gboolean

Определяет, влияет ли этот тег на размер шрифта.

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

Значение по умолчанию: FALSE

Свойство “stretch”

  “stretch”                  PangoStretch

Начертание шрифта как PangoStretch, например, PANGO_STRETCH_CONDENSED.

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

Значение по умолчанию: PANGO_STRETCH_NORMAL

Свойство “stretch-set”

  “stretch-set”              gboolean

Определяет, влияет ли этот тег на начертание шрифта.

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

Значение по умолчанию: FALSE

Свойство “strikethrough”

  “strikethrough”            gboolean

Определяет, нужно ли прочеркивать текст.

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

Значение по умолчанию: FALSE

Свойство “strikethrough-rgba”

  “strikethrough-rgba”       GdkRGBA *

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

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

С: 3.16

Свойство “strikethrough-rgba-set”

  “strikethrough-rgba-set”   gboolean

Если свойство “strikethrough-rgba” задано.

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

Значение по умолчанию: FALSE

С: 3.16

Свойство “strikethrough-set”

  “strikethrough-set”        gboolean

Определяет, влияет ли этот тег на прочеркивание.

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

Значение по умолчанию: FALSE

Свойство “style”

  “style”                    PangoStyle

Стиль шрифта как PangoStyle, например, PANGO_STYLE_ITALIC.

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

Значение по умолчанию: PANGO_STYLE_NORMAL

Свойство “style-set”

  “style-set”                gboolean

Определяет, влияет ли этот тег на стиль шрифта.

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

Значение по умолчанию: FALSE

Свойство “tabs”

  “tabs”                     PangoTabArray *

Настраиваемые табуляции для этого текста.

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

Свойство “tabs-set”

  “tabs-set”                 gboolean

Определяет, влияет ли этот тег на табуляции.

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

Значение по умолчанию: FALSE

Свойство “underline”

  “underline”                PangoUnderline

Стиль подчеркивания для этого текста.

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

Значение по умолчанию: PANGO_UNDERLINE_NONE

Свойство “underline-rgba”

  “underline-rgba”           GdkRGBA *

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

Если “underline” установлено в PANGO_UNDERLINE_ERROR, может быть применен альтернативный цвет вместо цвета переднего плана. Установка этого свойства всегда переопределяет эти значения по умолчанию.

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

С: 3.16

Свойство “underline-rgba-set”

  “underline-rgba-set”       gboolean

Если свойство “underline-rgba” установлено.

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

Значение по умолчанию: FALSE

С: 3.16

Свойство “underline-set”

  “underline-set”            gboolean

Определяет, влияет ли этот тег на подчеркивание.

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

Значение по умолчанию: FALSE

Свойство “variant”

  “variant”                  PangoVariant

Вариант шрифта как PangoVariant, например, PANGO_VARIANT_SMALL_CAPS.

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

Значение по умолчанию: PANGO_VARIANT_NORMAL

Свойство “variant-set”

  “variant-set”              gboolean

Определяет, влияет ли этот тег на вариант шрифта.

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

Значение по умолчанию: FALSE

Свойство “weight”

  “weight”                   gint

Вес шрифта как целое число, см. предопределенные значения в PangoWeight; например, PANGO_WEIGHT_BOLD.

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

Допустимые значения: >= 0

Значение по умолчанию: 400

Свойство “weight-set”

  “weight-set”               gboolean

Определяет, влияет ли этот тег на вес шрифта.

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

Значение по умолчанию: FALSE

Свойство “wrap-mode”

  “wrap-mode”                GtkWrapMode

Определяет, как переносить строки: никогда, по границам слов или по границам символов.

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

Значение по умолчанию: GTK_WRAP_NONE

Свойство “wrap-mode-set”

  “wrap-mode-set”            gboolean

Определяет, влияет ли этот тег на режим переноса строк.

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

Значение по умолчанию: FALSE