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 d’objet de document (DOM) Aspose.Words article de documentation.
public class TabStopCollection : InternableComplexAttr
Propriétés
| Nom | La 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
| Nom | La 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é est égal en valeur à l’objet actuel. |
| Equals(TabStopCollection) | Détermine si le spécifiéTabStopCollection est égal 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 de paragraphe ou directement dans celles d’un paragraphe. Un style peut être basé sur un autre style. Par conséquent, l’ensemble des taquets de tabulation d’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 unTabStopCollection pour un paragraphe ou un style, il 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 ou les taquets de tabulation par défaut.
Exemples
Montre comment travailler avec 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 constructeur à 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 d'arrêts de tabulation, qui clone ses valeurs à partir de la collection d'arrêts 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 d'arrêts de tabulation peut nous indiquer des arrêts de tabulation 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 tabulations 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
- class InternableComplexAttr
- espace de noms Aspose.Words
- Assemblée Aspose.Words
