Trabajar con listas
Una lista en un documento Microsoft Word es un conjunto de propiedades de formato de párrafo. Las listas se pueden utilizar en documentos para estructurar, organizar y resaltar texto. Las listas son una excelente manera de organizar datos en documentos de una manera que facilite a los lectores absorber y comprender los puntos clave.
Cada lista puede tener hasta 9 niveles y las propiedades de formato, como estilo de número, valor inicial, sangría, posición de tabulación y otras, se definen por separado para cada nivel.
En Aspose.Words, trabajar con listas está representado por el espacio de nombres Lists. Sin embargo, el objeto List siempre pertenece al formato ListCollection.
Este artículo describe cómo trabajar mediante programación con listas usando Aspose.Words.
Crear listas aplicando formato de lista
Aspose.Words permite la creación sencilla de listas aplicando formato de lista. DocumentBuilder proporciona la propiedad ListFormat que devuelve un objeto ListFormat. Este objeto tiene varios métodos para iniciar y finalizar una lista y aumentar/disminuir la sangría. Hay dos tipos generales de listas en Microsoft Word: con viñetas y numeradas:
- Para iniciar una lista con viñetas, llame a ApplyBulletDefault
- Para iniciar una lista numerada, llame a ApplyNumberDefault
La viñeta o el número y el formato se agregan al párrafo actual y a todos los párrafos posteriores creados usando DocumentBuilder hasta que se llama a RemoveNumbers para detener el formato de la lista con viñetas.
En los documentos de Word, las listas pueden constar de hasta nueve niveles. El formato de lista para cada nivel especifica qué viñeta o número se utiliza, sangría izquierda, espacio entre la viñeta y el texto, etc. Los siguientes métodos cambian el nivel de la lista y aplican las propiedades de formato del nuevo nivel:
- Para aumentar el nivel de lista del párrafo actual en un nivel, llame a ListIndent
- Para disminuir el nivel de lista del párrafo actual en un nivel, llame a ListOutdent
También puede utilizar la propiedad ListLevelNumber para obtener o establecer el nivel de lista del párrafo.
El siguiente ejemplo de código muestra cómo crear una lista multinivel:
Especificar formato para un nivel de lista
Los objetos a nivel de lista se crean automáticamente cuando se crea una lista. Utilice las propiedades y métodos de la clase ListLevel para controlar el formato de niveles individuales de una lista.
Lista de reinicio para cada sección
Puede reiniciar una lista para cada sección usando la propiedad IsRestartAtEachSection. Tenga en cuenta que esta opción sólo se admite en formatos de documentos RTF, DOC y DOCX. Esta opción se escribirá en DOCX solo si OoxmlCompliance es superior a Ecma376.
El siguiente ejemplo de código muestra cómo crear una lista y reiniciarla para cada sección: