Trabalhando com listas
Uma lista em uma Microsoft Word documento é um conjunto de propriedades de formatação de lista. Listas podem ser usadas em seus documentos para formatar, organizar e enfatizar texto. As listas são uma ótima maneira de organizar dados em documentos, e facilitam que os leitores compreendam pontos-chave.
Cada lista pode ter até 9 níveis e propriedades de formatação, tais como o estilo do número, o valor de início, o recuo, a posição da guia e outros são definidos separadamente para cada nível.
Este artigo descreve programaticamente trabalhando com listas usando Aspose.Words.
Criando listas aplicando formatação de lista
Aspose.Words permite a criação fácil de listas aplicando a formatação da lista. DocumentBuilder fornece o ListFormat propriedade que retorna uma ListFormat objeto. Este objeto tem vários métodos para iniciar e terminar uma lista e aumentar/diminuir o recuo. Existem dois tipos gerais de listas em Microsoft Word: balada e numerada:
- Para iniciar uma lista, ligue ListFormat.ApplyBulletDefault
- Para iniciar uma lista numerada, ligue ListFormat.ApplyNumberDefault
A bala ou número e formatação são adicionados ao parágrafo atual e todos os outros parágrafos criados usando DocumentBuilder até RemoveNumbers é chamado para parar a formatação da lista com marcadores.
Em documentos do Word, as listas podem consistir em até nove níveis. A formatação da lista para cada nível especifica o que a bala ou o número é usado, o recuo esquerdo, o espaço entre a bala e o texto etc. Os seguintes métodos mudam o nível de lista e aplicam as propriedades de formatação do novo nível:
- Não. Para aumentar o nível de lista do parágrafo atual por um nível, ligue ListFormat.ListIndent
- Não. Para diminuir o nível de lista do parágrafo atual por um nível, ligue ListFormat.ListOutdent
Os métodos mudam o nível de lista e aplicam as propriedades de formatação do novo nível.
O exemplo de código a seguir mostra como construir uma lista multinível:
Especificar formatação para um nível de lista
Os objetos de nível de lista são criados automaticamente quando uma lista é criada. Use as propriedades e métodos do ListLevel classe para controlar a formatação de níveis individuais de uma lista.
Lista de reinício para cada seção
Você pode reiniciar uma lista para cada seção usando o IsRestartAtEachSection propriedade. Note que esta opção é suportada apenas em formatos de documento RTF, DOC e DOCX. Esta opção será escrita apenas para DOCX se OoxmlCompliance é maior, então Ecma376.
O exemplo de código a seguir mostra como criar uma lista e reiniciá-la para cada seção: