TabStopCollection

TabStopCollection class

Una colección deTabStop objetos que representan pestañas personalizadas para un párrafo o un estilo.

Para obtener más información, visite elModelo de objetos de documento (DOM) de Aspose.Words artículo de documentación.

public class TabStopCollection : InternableComplexAttr

Propiedades

NombreDescripción
Count { get; }Obtiene el número de tabulaciones en la colección.
Item { get; }Obtiene una tabulación en el índice dado. (2 indexers)

Métodos

NombreDescripción
Add(TabStop)Agrega o reemplaza una tabulación en la colección.
Add(double, TabAlignmentTabLeader)Agrega o reemplaza una tabulación en la colección.
After(double)Obtiene una primera tabulación a la derecha de la posición especificada.
Before(double)Obtiene una primera tabulación a la izquierda de la posición especificada.
Clear()Elimina todas las posiciones de tabulación.
override Equals(object)Determina si el objeto especificado tiene el mismo valor que el objeto actual.
Equals(TabStopCollection)Determina si el especificadoTabStopCollection es igual en valor a la corrienteTabStopCollection .
override GetHashCode()Sirve como función hash para este tipo.
GetIndexByPosition(double)Obtiene el índice de una tabulación con la posición especificada en puntos.
GetPositionByIndex(int)Obtiene la posición (en puntos) de la tabulación en el índice especificado.
RemoveByIndex(int)Elimina una tabulación en el índice especificado de la colección.
RemoveByPosition(double)Elimina una tabulación en la posición especificada de la colección.

Observaciones

En los documentos de Microsoft Word, una tabulación se puede definir en las propiedades de un estilo parrafo o directamente en las propiedades de un párrafo. Un estilo puede basarse en otro estilo. Por lo tanto, el conjunto completo de tabulaciones para un objeto determinado es una combinación de tabulaciones definidas directamente en este objeto y tabulaciones heredadas de los estilos principales.

En Aspose.Words, cuando obtienes unTabStopCollectionpara un párrafo o un estilo, contiene solo las tabulaciones personalizadas definidas directamente para este párrafo o estilo. La colección no incluye tabulaciones definidas en los estilos principales o tabulaciones predeterminadas.

Ejemplos

Muestra cómo trabajar con la colección de tabulaciones de un documento.

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

TabStopCollection tabStops = builder.ParagraphFormat.TabStops;

// 72 puntos es una "pulgada" en la regla de tabulación 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]));

// Cada carácter de "tabulación" lleva el cursor del constructor a la ubicación de la siguiente tabulación.
builder.Writeln("Start\tTab 1\tTab 2");

ParagraphCollection paragraphs = doc.FirstSection.Body.Paragraphs;

Assert.AreEqual(2, paragraphs.Count);

// Cada párrafo obtiene su colección de tabulaciones, que clona sus valores de la colección de tabulaciones del creador de documentos.
Assert.AreEqual(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);
Assert.AreNotSame(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);

// Una colección de tabulaciones puede indicarnos TabStops antes y después de ciertas posiciones.
Assert.AreEqual(72.0, tabStops.Before(100.0).Position);
Assert.AreEqual(432.0, tabStops.After(100.0).Position);

// Podemos borrar la colección de tabulaciones de un párrafo para volver al comportamiento de tabulación predeterminado.
paragraphs[1].ParagraphFormat.TabStops.Clear();

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

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

Ver también