TabStopCollection

TabStopCollection class

Eine Sammlung vonTabStop Objekte, die benutzerdefinierte Registerkarten für einen Absatz oder einen Stil darstellen.

Um mehr zu erfahren, besuchen Sie dieAspose.Words Dokumentobjektmodell (DOM) Dokumentationsartikel.

public class TabStopCollection : InternableComplexAttr

Eigenschaften

Name	Beschreibung
Count { get; }	Ruft die Anzahl der Tabstopps in der Sammlung ab.
Item { get; }	Ruft einen Tabulatorstopp am angegebenen Index ab. (2 indexers)

Methoden

Name	Beschreibung
Add(TabStop)	Fügt einen Tabulator in der Sammlung hinzu oder ersetzt ihn.
Add(double, TabAlignment, TabLeader)	Fügt einen Tabulator in der Sammlung hinzu oder ersetzt ihn.
After(double)	Ruft einen ersten Tabulatorstopp rechts von der angegebenen Position ab.
Before(double)	Ruft einen ersten Tabulatorstopp links von der angegebenen Position ab.
Clear()	Löscht alle Tabstopppositionen.
override Equals(object)	Bestimmt, ob das angegebene Objekt den gleichen Wert wie das aktuelle Objekt hat.
Equals(TabStopCollection)	Bestimmt, ob die angegebene`TabStopCollection` ist im Wert gleich dem aktuellen`TabStopCollection` .
override GetHashCode()	Dient als Hash-Funktion für diesen Typ.
GetIndexByPosition(double)	Ruft den Index eines Tabulators mit der angegebenen Position in Punkten ab.
GetPositionByIndex(int)	Ruft die Position (in Punkten) des Tabulatorstopps am angegebenen Index ab.
RemoveByIndex(int)	Entfernt einen Tabulatorstopp am angegebenen Index aus der Auflistung.
RemoveByPosition(double)	Entfernt einen Tabulator an der angegebenen Position aus der Auflistung.

Bemerkungen

In Microsoft Word-Dokumenten kann ein Tabstopp in den Eigenschaften eines Absatzstils oder direkt in den Eigenschaften eines Absatzes definiert werden. Ein Stil kann auf einem anderen Stil basieren. Daher ist der vollständige Tabstoppsatz für ein bestimmtes Objekt eine Kombination aus direkt für dieses Objekt definierten Tabstopps und von den übergeordneten Stilen übernommenen Tabstopps.

In Aspose.Words, wenn Sie eineTabStopCollection für einen Absatz oder einen Stil enthält es nur die benutzerdefinierten Tabstopps, die direkt für diesen Absatz oder Stil definiert sind. Die Sammlung enthält keine Tabstopps, die in den übergeordneten Stilen oder Standard-Tabstopps definiert sind.

Beispiele

Zeigt, wie mit der Tabstopp-Sammlung eines Dokuments gearbeitet wird.

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

TabStopCollection tabStops = builder.ParagraphFormat.TabStops;

// 72 Punkte sind ein „Zoll“ auf dem Tabstopplineal von 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]));

// Jedes „Tabulator“-Zeichen bringt den Cursor des Builders an die Position des nächsten Tabulatorstopps.
builder.Writeln("Start\tTab 1\tTab 2");

ParagraphCollection paragraphs = doc.FirstSection.Body.Paragraphs;

Assert.AreEqual(2, paragraphs.Count);

// Jeder Absatz erhält seine Tabstopp-Sammlung, die ihre Werte aus der Tabstopp-Sammlung des Dokument-Generators klont.
Assert.AreEqual(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);
Assert.AreNotSame(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);

// Eine Tabstopp-Sammlung kann uns auf TabStops vor und nach bestimmten Positionen verweisen.
Assert.AreEqual(72.0, tabStops.Before(100.0).Position);
Assert.AreEqual(432.0, tabStops.After(100.0).Position);

// Wir können die Tabstopp-Sammlung eines Absatzes löschen, um zum Standard-Tabulatorverhalten zurückzukehren.
paragraphs[1].ParagraphFormat.TabStops.Clear();

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

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

Siehe auch

TabStop Class TableStyle Class