ListFormat

ListFormat class

Permite controlar qué formato de lista se aplica a un párrafo.

Para obtener más información, visite elTrabajar con listas artículo de documentación.

public class ListFormat

Propiedades

NombreDescripción
IsListItem { get; }Verdadero cuando al párrafo se le ha aplicado formato numerado o con viñetas.
List { get; set; }Obtiene o establece la lista de la que este párrafo es miembro.
ListLevel { get; }Devuelve el formato a nivel de lista más cualquier anulación de formato aplicada al párrafo actual.
ListLevelNumber { get; set; }Obtiene o establece el número de nivel de lista (0 a 8) para el párrafo.

Métodos

NombreDescripción
ApplyBulletDefault()Inicia una nueva lista con viñetas predeterminada y la aplica al párrafo.
ApplyNumberDefault()Inicia una nueva lista numerada predeterminada y la aplica al párrafo.
ListIndent()Aumenta el nivel de lista del párrafo actual en un nivel.
ListOutdent()Disminuye el nivel de lista del párrafo actual en un nivel.
RemoveNumbers()Elimina números o viñetas del párrafo actual y establece el nivel de lista en cero.

Observaciones

Un párrafo en un documento de Microsoft Word puede tener viñetas o numerarse. Cuando un párrafo tiene viñetas o numerarse, se dice que se aplica el formato de lista al párrafo.

No creas objetos delListFormat clase directamente. AccedesListFormat como propiedad de otro objeto que puede tener formato de lista asociado. Actualmente los objetos que can tienen formato de lista son:Paragraph , Style yDocumentBuilder.

ListFormat de unParagraph especifica qué formato de lista y nivel de lista se aplica a ese párrafo en particular.

ListFormat de unStyle (aplicable solo a estilos de párrafo) permite especificar qué formato de lista y nivel de lista se aplica a todos los párrafos de ese estilo en particular.

ListFormat de unDocumentBuilder proporciona acceso al formato de la lista en la posición actual del cursor dentro delDocumentBuilder.

El formato de la lista en sí se almacena dentro de unList objeto que se almacena por separado de los párrafos. La lista de objetos se almacena dentro de unListCollection recopilación. Hay un single ListCollection colección porDocument.

Los párrafos no pertenecen físicamente a una lista. Los párrafos just hacen referencia a un objeto de lista particular a través de laList property y un nivel particular en la lista a través delListLevelNumber property. Al establecer estas dos propiedades, usted controla qué viñetas y numeración se se aplican a un párrafo.

Ejemplos

Muestra cómo trabajar con niveles de lista.

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

Assert.False(builder.ListFormat.IsListItem);

// Una lista nos permite organizar y decorar conjuntos de párrafos con símbolos de prefijo y sangrías.
 // Podemos crear listas anidadas aumentando el nivel de sangría.
 // Podemos comenzar y finalizar una lista utilizando la propiedad "ListFormat" del generador de documentos.
// Cada párrafo que agreguemos entre el inicio y el final de una lista se convertirá en un elemento de la lista.
// A continuación se muestran dos tipos de listas que podemos crear usando un generador de documentos.
// 1 - Una lista numerada:
// Las listas numeradas crean un orden lógico para sus párrafos numerando cada elemento.
builder.ListFormat.List = doc.Lists.Add(ListTemplate.NumberDefault);

Assert.True(builder.ListFormat.IsListItem);

// Al establecer la propiedad "ListLevelNumber", podemos aumentar el nivel de la lista
// para comenzar una sublista autónoma en el elemento de la lista actual.
// La plantilla de lista de Microsoft Word llamada "NumberDefault" usa números para crear niveles de lista para el primer nivel de lista.
 // Los niveles de lista más profundos utilizan letras y números romanos en minúscula.
for (int i = 0; i < 9; i++)
{
    builder.ListFormat.ListLevelNumber = i;
    builder.Writeln("Level " + i);
}

// 2 - Una lista con viñetas:
// Esta lista aplicará una sangría y un símbolo de viñeta ("•") antes de cada párrafo.
// Los niveles más profundos de esta lista utilizarán diferentes símbolos, como "■" y "○".
builder.ListFormat.List = doc.Lists.Add(ListTemplate.BulletDefault);

for (int i = 0; i < 9; i++)
{
    builder.ListFormat.ListLevelNumber = i;
    builder.Writeln("Level " + i);
}

// Podemos deshabilitar el formato de la lista para no formatear ningún párrafo posterior como lista al desactivar el indicador "Lista".
builder.ListFormat.List = null;

Assert.False(builder.ListFormat.IsListItem);

doc.Save(ArtifactsDir + "Lists.SpecifyListLevel.docx");

Ver también

ListCollection Class ListLabel Class