TabStopCollection

TabStopCollection class

En samling avTabStop objekt som representerar anpassade flikar för ett stycke eller en stil.

För att lära dig mer, besökAspose.Words-dokumentobjektmodell (DOM) dokumentationsartikel.

public class TabStopCollection : InternableComplexAttr

Egenskaper

namnBeskrivning
Count { get; }Hämtar antalet tabbstopp i samlingen.
Item { get; }Hämtar ett tabbstopp vid det angivna indexet. (2 indexers)

Metoder

namnBeskrivning
Add(TabStop)Lägger till eller ersätter ett tabbstopp i samlingen.
Add(double, TabAlignment, TabLeader)Lägger till eller ersätter ett tabbstopp i samlingen.
After(double)Hämtar ett första tabbstopp till höger om den angivna positionen.
Before(double)Hämtar ett första tabbstopp till vänster om den angivna positionen.
Clear()Tar bort alla tabbstoppspositioner.
override Equals(object)Avgör om det angivna objektet har samma värde som det aktuella objektet.
Equals(TabStopCollection)Avgör om den angivnaTabStopCollection är lika värdefullt som den nuvarandeTabStopCollection .
override GetHashCode()Fungerar som en hashfunktion för den här typen.
GetIndexByPosition(double)Hämtar indexet för ett tabbstopp med den angivna positionen i punkter.
GetPositionByIndex(int)Hämtar positionen (i punkter) för tabbstoppet vid det angivna indexet.
RemoveByIndex(int)Tar bort ett tabbstopp vid det angivna indexet från samlingen.
RemoveByPosition(double)Tar bort ett tabbstopp vid den angivna positionen från samlingen.

Anmärkningar

I Microsoft Word-dokument kan ett tabbstopp definieras i egenskaperna för en paragraph -stil eller direkt i egenskaperna för ett stycke. Ett format kan baseras på ett annat format. Därför är den kompletta uppsättningen tabbstopp för ett givet objekt en kombination av tabbstopp som definierats direkt på detta objekt och tabbstopp som ärvts från de överordnade formaten.

Med andra ord, när du får enTabStopCollection För ett stycke eller en stil innehåller den endast de anpassade tabbstopp som definierats direkt för detta stycke eller stil. Samlingen inkluderar inte tabbstopp som definierats i de överordnade stilarna eller standardtabbstopp.

Exempel

Visar hur man arbetar med ett dokuments samling av tabbstopp.

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

TabStopCollection tabStops = builder.ParagraphFormat.TabStops;

// 72 punkter är en "tum" på tabbstoppslinjalen i 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]));

// Varje "tab"-tecken tar byggarens markör till platsen för nästa tabbstopp.
builder.Writeln("Start\tTab 1\tTab 2");

ParagraphCollection paragraphs = doc.FirstSection.Body.Paragraphs;

Assert.AreEqual(2, paragraphs.Count);

// Varje stycke får sin tabbstoppsamling, som klonar dess värden från dokumentbyggarens tabbstoppsamling.
Assert.AreEqual(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);
Assert.AreNotSame(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);

// En tabulatursamling kan peka oss till tabulaturer före och efter vissa positioner.
Assert.AreEqual(72.0, tabStops.Before(100.0).Position);
Assert.AreEqual(432.0, tabStops.After(100.0).Position);

// Vi kan rensa ett styckes tabbstoppsamling för att återgå till standardbeteendet för tabbning.
paragraphs[1].ParagraphFormat.TabStops.Clear();

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

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

Se även

TabStop Class TableStyle Class