Les TextTag peuvent porter un nom ou bien être anonymes. On crée une TextTag en utilisant la fonction :

  balise = gtk.TextTag(name=None)

Si aucun name (nom) n'est donné ou s'il vaut None, la balise sera anonyme. Il peut être plus commode de créer des TextTag avec la méthode de TextBuffer create_tag(), celle-ci permettant aussi de spécifier les attributs de la balise et de l'ajouter à la table des balises du buffer (cf. la section TextBuffer)

Les attributs que peut porter une TextTag sont :

On peut définir les attributs d'une balise avec la méthode :

  balise.set_property(nom_attr, valeur)

dans laquelle nom_attr est une chaine contenant le nom de l'attribut et valeur la valeur qui doit lui être affectée.

De la même manière, on peut récupérer la valeur de l'attribut avec la méthode :

  valeur = balise.get_property(nom_attr)

Du fait qu'une balise ne contient pas forcément tous les attributs précédemment cités, un certain nombre de propriétés booléennes ont été créées, qui permettent simplement de savoir si la balise est porteuse ou pas de tel attribut :

Pour récupérer un attribut d'une balise, vous devez donc d'abord vérifier s'il est bien défini dans cette balise. Par exemple, pour obtenir un attribut valide d'alignement, vous pourriez procéder comme suit :

  if balise.get_property("justification_set"):
	alignement = balise.get_property("justification")

Par défaut, la priorité des balises correspond à l'ordre dans lequel elles sont ajoutées à la TextTagTable. La balise qui a la plus haute priorité prend l'avantage dans le cas où plusieurs tentent de définir le même attribut pour une portion de texte. La priorité se récupère et se définit avec les méthodes suivantes :

  priorite = balise.get_priority()

  balise.set_priority(priorite)

La priorité d'une balise doit être comprise entre 0 et la taille de la TextTagTable moins 1.

Par défaut, une TextTagTable est créée avec la création d'un TextBuffer. Mais elle peut tout aussi bien être créée par la fonction :

  table = TextTagTable()

On ajoute une TextTag a une TextTagTable avec la méthode :

  table.add(balise)

La balise ne doit pas déjà être dans la table et ne doit pas porter le même nom qu'une balise s'y trouvant déjà.

On peut chercher une TextTag dans une TextTagTable en utilisant la méthode :

  balise = table.lookup(nom)

La méthode renvoie la balise qui porte ce nom dans la table, ou None si aucune balise ne porte ce nom.

On peut retirer une TextTag d'une TextTagTable avec la méthode :

  table.remove(balise)

Enfin, la taille d'une TextTagTable peut être récupérée par :

  taille_table = table.get_size()