TextTag могут иметь имя или быть анонимными. TextTag создаётся с помощью функции:

  tag = gtk.TextTag(name=None)

Если name не указано или None, то tag будет анонимным. Также TextTag может быть создан с помощью метода TextBuffer.create_tag(), который также позволяет указывать атрибуты для tag, и добавлять их в таблицу (см. Раздел 13.3, “Текстовый буфер”).

Атрибуты, которые могут содержаться в TextTag:

Атрибуты могут быть изменены с помощью метода:

  tag.set_property(name, value)

Где name это строка содержащая имя свойства, а value это значение свойства.

Похожим образом, атрибуты могут быть получены с помощью метода:

  value = tag.get_property(name)

Пока признаку не присвоено значение, то используется его значение по умолчанию. Существует набор логических свойств, которые показывают, был ли изменён признак:

Для получения атрибута из признака, сначала проверьте, изменялся ли он. Например, для получения правильного значения выравнивания, можно сделать что-то вроде этого:

  if tag.get_property("justification-set"):
	justification = tag.get_property("justification")

Приоритет признаков по умолчанию зависит от порядка добавления признаков в таблицу. Приоритет может быть получен с помощью метода:

  priority = tag.get_priority()

  tag.set_priority(priority)

Приоритет признака может быть между 0 и размером таблицы признаков – 1.

TextTagTable по умолчанию создаётся вместе с TextBuffer. TextTagTable также может быть создана с помощью функции:

  table = gtk.TextTagTable()

TextTag может быть добавлен на TextTagTable с помощью метода:

  table.add(tag)

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

Вы можете найти TextTag в TextTagTable используя метод:

  tag = table.lookup(name)

Этот метод возвращает tag с заданным именем из таблицы или None, если признак с именем name не найден .

TextTag может быть удалён из TextTagTable с помощью метода:

  table.remove(tag)

Размер TextTagTable может быть получен с помощью метода:

  size = table.get_size()