Trabajar con Listas
Una lista en un documento Microsoft Word es un conjunto de propiedades de formato de lista. Las listas se pueden usar en sus documentos para formatear, organizar y enfatizar el texto. Las listas son una excelente manera de organizar los datos en los documentos y facilitan a los lectores la comprensión de los puntos clave.
Cada lista puede tener hasta 9 niveles y las propiedades de formato, como el estilo del número, el valor inicial, la sangría, la posición de la pestaña y otras, se definen por separado para cada nivel.
Este artículo describe el trabajo programático con listas usando Aspose.Words.
Creación de 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 para 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 ListFormat.ApplyBulletDefault
- Para iniciar una lista numerada, llame a ListFormat.ApplyNumberDefault
La viñeta o el número y el formato se agregan al párrafo actual y a todos los párrafos adicionales creados con DocumentBuilder hasta que se llame 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 usa, 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 ListFormat.ListIndent
- Para disminuir el nivel de lista del párrafo actual en un nivel, llame a ListFormat.ListOutdent
Los métodos cambian el nivel de la lista y aplican las propiedades de formato del nuevo nivel.
El siguiente ejemplo de código muestra cómo crear una lista multinivel:
Especificar formato para un Nivel de lista
Los objetos de nivel de lista se crean automáticamente cuando se crea una lista. Utilice las propiedades y los métodos de la clase ListLevel para controlar el formato de los niveles individuales de una lista.
Lista de reinicio para cada Sección
Puede reiniciar una lista para cada sección utilizando la propiedad IsRestartAtEachSection. Tenga en cuenta que esta opción solo es compatible con los formatos de documento RTF, DOC y DOCX. Esta opción se escribirá en DOCX solo si OoxmlCompliance es mayor que Ecma376.
El siguiente ejemplo de código muestra cómo crear una lista y reiniciarla para cada sección: