TabStopCollection

TabStopCollection class

Une collection deTabStop objets qui représentent des onglets personnalisés pour un paragraphe ou un style.

Pour en savoir plus, visitez leModèle objet de document (DOM) Aspose.Words article documentaire.

public class TabStopCollection : InternableComplexAttr

Propriétés

NomLa description
Count { get; }Obtient le nombre de taquets de tabulation dans la collection.
Item { get; }Obtient un taquet de tabulation à l’index donné. (2 indexers)

Méthodes

NomLa description
Add(TabStop)Ajoute ou remplace un taquet de tabulation dans la collection.
Add(double, TabAlignment, TabLeader)Ajoute ou remplace un taquet de tabulation dans la collection.
After(double)Obtient un premier taquet de tabulation à droite de la position spécifiée.
Before(double)Obtient un premier taquet de tabulation à gauche de la position spécifiée.
Clear()Supprime toutes les positions de taquet de tabulation.
override Equals(object)Détermine si l’objet spécifié a une valeur égale à l’objet actuel.
Equals(TabStopCollection)Détermine si leTabStopCollection est égale en valeur au courantTabStopCollection .
override GetHashCode()Sert de fonction de hachage pour ce type.
GetIndexByPosition(double)Obtient l’index d’un taquet de tabulation avec la position spécifiée en points.
GetPositionByIndex(int)Obtient la position (en points) du taquet de tabulation à l’index spécifié.
RemoveByIndex(int)Supprime un taquet de tabulation à l’index spécifié de la collection.
RemoveByPosition(double)Supprime un taquet de tabulation à la position spécifiée de la collection.

Remarques

Dans les documents Microsoft Word, un taquet de tabulation peut être défini dans les propriétés d’un style paragraphe ou directement dans les propriétés d’un paragraphe. Un style peut être basé sur un autre style. Ainsi, l’ensemble complet des taquets de tabulation pour un objet donné est une combinaison de taquets de tabulation définis directement sur cet objet et de taquets de tabulation hérités des styles parents.

Dans Aspose.Words, lorsque vous obtenez unTabStopCollectionpour un paragraphe ou un style, elle contient uniquement les taquets de tabulation personnalisés définis directement pour ce paragraphe ou ce style. La collection n’inclut pas les taquets de tabulation définis dans les styles parents ni les taquets de tabulation par défaut.

Exemples

Montre comment utiliser la collection de taquets de tabulation d’un document.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

TabStopCollection tabStops = builder.ParagraphFormat.TabStops;

// 72 points correspondent à un "pouce" sur la règle de tabulation de Microsoft Word.
tabStops.Add(new TabStop(72.0));
tabStops.Add(new TabStop(432.0, TabAlignment.Right, TabLeader.Dashes));

Assert.AreEqual(2, tabStops.Count);
Assert.IsFalse(tabStops[0].IsClear);
Assert.IsFalse(tabStops[0].Equals(tabStops[1]));

// Chaque caractère "tabulation" amène le curseur du générateur à l'emplacement du prochain taquet de tabulation.
builder.Writeln("Start\tTab 1\tTab 2");

ParagraphCollection paragraphs = doc.FirstSection.Body.Paragraphs;

Assert.AreEqual(2, paragraphs.Count);

// Chaque paragraphe obtient sa collection de taquets de tabulation, qui clone ses valeurs à partir de la collection de taquets de tabulation du générateur de documents.
Assert.AreEqual(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);
Assert.AreNotSame(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);

// Une collection de taquets de tabulation peut nous pointer vers des TabStops avant et après certaines positions.
Assert.AreEqual(72.0, tabStops.Before(100.0).Position);
Assert.AreEqual(432.0, tabStops.After(100.0).Position);

// Nous pouvons effacer la collection de taquets de tabulation d'un paragraphe pour revenir au comportement de tabulation par défaut.
paragraphs[1].ParagraphFormat.TabStops.Clear();

Assert.AreEqual(0, paragraphs[1].ParagraphFormat.TabStops.Count);

doc.Save(ArtifactsDir + "TabStopCollection.TabStopCollection.docx");

Voir également

TabStop Class TableStyle Class