Trabajando con listas
Una lista en una Microsoft Word documento es un conjunto de propiedades de formato de lista. Las listas se pueden utilizar en sus documentos para formatear, organizar y enfatizar el texto. Las listas son una gran manera de organizar datos en documentos, y facilitan que los lectores comprendan puntos clave.
Cada lista puede tener hasta 9 niveles y propiedades de formato, como el estilo de número, el valor de inicio, la posición de entrada, y otros se definen por separado para cada nivel.
Este artículo describe programáticamente trabajar con listas usando Aspose.Words.
Creación de listas mediante el formato de lista de aplicaciones
Aspose.Words permite la fácil creación de listas aplicando formato de lista. DocumentBuilder proporciona el ListFormat propiedad que devuelve un ListFormat objeto. Este objeto tiene varios métodos para iniciar y terminar una lista y aumentar/disminuir el indent. Hay dos tipos generales de listas en Microsoft Word: balada y numerada:
- Para empezar una lista de balas, llama ListFormat.ApplyBulletDefault
- Para empezar una lista numerada, llame ListFormat.ApplyNumberDefault
La bala o el número y el formato se añaden al párrafo actual y todos los párrafos adicionales creados utilizando DocumentBuilder hasta RemoveNumbers se llama para detener el formato de lista de balas.
En documentos de Word, las listas pueden consistir en hasta nueve niveles. El formato de lista para cada nivel especifica qué bala o número se utiliza, indent izquierdo, espacio entre la bala y el texto, etc. Los siguientes métodos cambian el nivel de lista y aplican las propiedades de formato del nuevo nivel:
- To increase the list level of the current paragraph by one level, call ListFormat.ListIndent
- Para reducir el nivel de lista del párrafo actual por un nivel, llame ListFormat.ListOutdent
Los métodos cambian el nivel de lista y aplican las propiedades de formato del nuevo nivel.
El siguiente ejemplo de código muestra cómo construir una lista multinivel:
Especifique el 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 métodos de los ListLevel clase 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 usando la IsRestartAtEachSection propiedad. Tenga en cuenta que esta opción sólo se admite en formatos de documentos RTF, DOC y DOCX. Esta opción se escribirá a DOCX sólo si OoxmlCompliance es mayor entonces Ecma376.
El siguiente ejemplo de código muestra cómo crear una lista y reiniciarla para cada sección: