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, отступы перекрывают друг друга (по умолчанию).

Владелец: GtkTextTag

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

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

С версии: 2.12

Свойство “background”

  “background”               char *

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

Владелец: GtkTextTag

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

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

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

  “background-full-height”   gboolean

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

Владелец: GtkTextTag

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

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

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

  “background-full-height-set” gboolean

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

Владелец: GtkTextTag

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

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

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

  “background-gdk”           GdkColor *

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

Владелец: GtkTextTag

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

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

  “background-rgba”          GdkRGBA *

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

Владелец: GtkTextTag

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

С версии: 3.2

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

  “background-set”           gboolean

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

Владелец: GtkTextTag

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

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

Свойство “direction”

  “direction”                GtkTextDirection

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

Владелец: GtkTextTag

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

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

Свойство “editable”

  “editable”                 gboolean

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

Владелец: GtkTextTag

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

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

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

  “editable-set”             gboolean

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

Владелец: GtkTextTag

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

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

Свойство “fallback”

  “fallback”                 gboolean

Включено ли использование резервных шрифтов.

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

Владелец: GtkTextTag

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

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

С версии: 3.16

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

  “fallback-set”             gboolean

Влияет ли этот тег на использование резервных шрифтов.

Владелец: GtkTextTag

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

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

Свойство “family”

  “family”                   char *

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

Владелец: GtkTextTag

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

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

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

  “family-set”               gboolean

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

Владелец: GtkTextTag

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

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

Свойство “font”

  “font”                     char *

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

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

Владелец: GtkTextTag

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

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

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

  “font-desc”                PangoFontDescription *

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

Владелец: GtkTextTag

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

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

  “font-features”            char *

Особенности шрифта OpenType в виде строки.

Владелец: GtkTextTag

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

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

С версии: 3.18

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

  “font-features-set”        gboolean

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

Владелец: GtkTextTag

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

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

Свойство “foreground”

  “foreground”               char *

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

Владелец: GtkTextTag

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

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

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

  “foreground-gdk”           GdkColor *

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

Владелец: GtkTextTag

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

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

  “foreground-rgba”          GdkRGBA *

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

Владелец: GtkTextTag

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

С версии: 3.2

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

  “foreground-set”           gboolean

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

Владелец: GtkTextTag

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

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

Свойство “indent”

  “indent”                   int

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

Владелец: GtkTextTag

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

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

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

  “indent-set”               gboolean

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

Владелец: GtkTextTag

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

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

Свойство “invisible”

  “invisible”                gboolean

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

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

Владелец: GtkTextTag

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

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

С версии: 2.8

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

  “invisible-set”            gboolean

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

Владелец: GtkTextTag

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

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

Свойство “justification”

  “justification”            GtkJustification

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

Владелец: GtkTextTag

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

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

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

  “justification-set”        gboolean

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

Владелец: GtkTextTag

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

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

Свойство “language”

  “language”                 char *

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

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

Владелец: GtkTextTag

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

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

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

  “language-set”             gboolean

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

Владелец: GtkTextTag

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

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

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

  “left-margin”              int

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

Владелец: GtkTextTag

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

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

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

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

  “left-margin-set”          gboolean

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

Владелец: GtkTextTag

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

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

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

  “letter-spacing”           int

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

Владелец: GtkTextTag

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

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

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

С версии: 3.16

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

  “letter-spacing-set”       gboolean

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

Владелец: GtkTextTag

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

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

Свойство “name”

  “name”                     char *

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

Владелец: GtkTextTag

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

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

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

  “paragraph-background”     char *

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

Владелец: GtkTextTag

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

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

С версии: 2.8

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

  “paragraph-background-gdk” GdkColor *

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

Владелец: GtkTextTag

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

С версии: 2.8

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

  “paragraph-background-rgba” GdkRGBA *

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

Владелец: GtkTextTag

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

С версии: 3.2

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

  “paragraph-background-set” gboolean

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

Владелец: GtkTextTag

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

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

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

  “pixels-above-lines”       int

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

Владелец: GtkTextTag

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

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

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

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

  “pixels-above-lines-set”   gboolean

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

Владелец: GtkTextTag

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

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

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

  “pixels-below-lines”       int

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

Владелец: GtkTextTag

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

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

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

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

  “pixels-below-lines-set”   gboolean

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

Владелец: GtkTextTag

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

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

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

  “pixels-inside-wrap”       int

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

Владелец: GtkTextTag

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

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

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

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

  “pixels-inside-wrap-set”   gboolean

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

Владелец: GtkTextTag

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

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

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

  “right-margin”             int

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

Владелец: GtkTextTag

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

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

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

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

  “right-margin-set”         gboolean

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

Владелец: GtkTextTag

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

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

Свойство “rise”

  “rise”                     int

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

Владелец: GtkTextTag

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

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

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

  “rise-set”                 gboolean

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

Владелец: GtkTextTag

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

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

Свойство “scale”

  “scale”                    double

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

Владелец: GtkTextTag

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

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

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

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

  “scale-set”                gboolean

Масштабирует ли этот тег размер шрифта с помощью коэффициента.

Владелец: GtkTextTag

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

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

Свойство “size”

  “size”                     int

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

Владелец: GtkTextTag

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

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

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

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

  “size-points”              double

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

Владелец: GtkTextTag

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

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

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

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

  “size-set”                 gboolean

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

Владелец: GtkTextTag

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

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

Свойство “stretch”

  “stretch”                  PangoStretch

Растяжение шрифта как PangoStretch, например PANGO_STRETCH_CONDENSED.

Владелец: GtkTextTag

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

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

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

  “stretch-set”              gboolean

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

Владелец: GtkTextTag

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

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

Свойство “strikethrough”

  “strikethrough”            gboolean

Нужно ли зачеркивать текст.

Владелец: GtkTextTag

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

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

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

  “strikethrough-rgba”       GdkRGBA *

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

Владелец: GtkTextTag

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

С версии: 3.16

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

  “strikethrough-rgba-set”   gboolean

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

Владелец: GtkTextTag

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

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

С версии: 3.16

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

  “strikethrough-set”        gboolean

Влияет ли этот тег на зачеркивание.

Владелец: GtkTextTag

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

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

Свойство “style”

  “style”                    PangoStyle

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

Владелец: GtkTextTag

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

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

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

  “style-set”                gboolean

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

Владелец: GtkTextTag

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

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

Свойство “tabs”

  “tabs”                     PangoTabArray *

Пользовательские табуляции для этого текста.

Владелец: GtkTextTag

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

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

  “tabs-set”                 gboolean

Влияет ли этот тег на табуляцию.

Владелец: GtkTextTag

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

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

Свойство “underline”

  “underline”                PangoUnderline

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

Владелец: GtkTextTag

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

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

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

  “underline-rgba”           GdkRGBA *

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

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

Владелец: GtkTextTag

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

С версии: 3.16

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

  “underline-rgba-set”       gboolean

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

Владелец: GtkTextTag

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

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

С версии: 3.16

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

  “underline-set”            gboolean

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

Владелец: GtkTextTag

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

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

Свойство “variant”

  “variant”                  PangoVariant

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

Владелец: GtkTextTag

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

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

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

  “variant-set”              gboolean

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

Владелец: GtkTextTag

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

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

Свойство “weight”

  “weight”                   int

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

Владелец: GtkTextTag

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

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

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

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

  “weight-set”               gboolean

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

Владелец: GtkTextTag

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

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

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

  “wrap-mode”                GtkWrapMode

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

Владелец: GtkTextTag

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

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

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

  “wrap-mode-set”            gboolean

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

Владелец: GtkTextTag

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

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