TabStopCollection

TabStopCollection class

Una raccolta diTabStop oggetti che rappresentano schede personalizzate per un paragrafo o uno stile.

Per saperne di più, visita ilModello oggetto documento Aspose.Words (DOM) articolo di documentazione.

public class TabStopCollection : InternableComplexAttr

Proprietà

NomeDescrizione
Count { get; }Ottiene il numero di tabulazioni nella raccolta.
Item { get; }Ottiene un punto di tabulazione all’indice specificato. (2 indexers)

Metodi

NomeDescrizione
Add(TabStop)Aggiunge o sostituisce un punto di tabulazione nella raccolta.
Add(double, TabAlignmentTabLeader)Aggiunge o sostituisce un punto di tabulazione nella raccolta.
After(double)Ottiene una prima tabulazione a destra della posizione specificata.
Before(double)Ottiene una prima tabulazione a sinistra della posizione specificata.
Clear()Elimina tutte le posizioni di tabulazione.
override Equals(object)Determina se l’oggetto specificato ha un valore uguale all’oggetto corrente.
Equals(TabStopCollection)Determina se specificatoTabStopCollection ha lo stesso valore della correnteTabStopCollection .
override GetHashCode()Serve come funzione hash per questo tipo.
GetIndexByPosition(double)Ottiene l’indice di una tabulazione con la posizione specificata in punti.
GetPositionByIndex(int)Ottiene la posizione (in punti) del punto di tabulazione in corrispondenza dell’indice specificato.
RemoveByIndex(int)Rimuove dalla raccolta un punto di tabulazione in corrispondenza dell’indice specificato.
RemoveByPosition(double)Rimuove un punto di tabulazione nella posizione specificata dalla raccolta.

Osservazioni

Nei documenti di Microsoft Word, una tabulazione può essere definita nelle proprietà di uno stile paragrafo o direttamente nelle proprietà di un paragrafo. Uno stile può essere basato su un altro stile. Pertanto, il set completo di tabulazioni per un dato oggetto è una combinazione di tabulazioni definite direttamente su questo oggetto e tabulazioni ereditate dagli stili principali.

In Aspose.Words, quando ottieni aTabStopCollectionper un paragrafo o uno stile, contiene solo i punti di tabulazione personalizzati definiti direttamente per questo paragrafo o stile. La raccolta non include i punti di tabulazione definiti negli stili principali o i punti di tabulazione predefiniti.

Esempi

Mostra come lavorare con la raccolta di tabulazioni di un documento.

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

TabStopCollection tabStops = builder.ParagraphFormat.TabStops;

// 72 punti corrispondono a un "pollice" sul righello delle tabulazioni di 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]));

// Ogni carattere "tab" porta il cursore del builder nella posizione del punto di tabulazione successivo.
builder.Writeln("Start\tTab 1\tTab 2");

ParagraphCollection paragraphs = doc.FirstSection.Body.Paragraphs;

Assert.AreEqual(2, paragraphs.Count);

// Ogni paragrafo ottiene la propria raccolta di tabulazioni, che ne clona i valori dalla raccolta di tabulazioni del generatore di documenti.
Assert.AreEqual(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);
Assert.AreNotSame(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);

// Una raccolta di tabulazioni può indirizzarci a TabStop prima e dopo determinate posizioni.
Assert.AreEqual(72.0, tabStops.Before(100.0).Position);
Assert.AreEqual(432.0, tabStops.After(100.0).Position);

// Possiamo cancellare la raccolta di tabulazioni di un paragrafo per ripristinare il comportamento di tabulazione predefinito.
paragraphs[1].ParagraphFormat.TabStops.Clear();

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

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

Guarda anche