GtkTextTag

Структура GtkTextTag

struct GtkTextTag;

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