Trabalhando com estilos e temas
A classe StyleCollection é usada para gerenciar configurações integradas e aplicar configurações definidas pelo usuário a estilos.
Acessando Estilos
Você pode obter uma coleção de estilos definidos no documento usando a propriedade Document.styles. Esta coleção contém os estilos integrados e definidos pelo usuário em um documento. Um estilo específico pode ser obtido por seu nome/alias, identificador de estilo ou índice. O exemplo de código a seguir demonstra como obter acesso à coleção de estilos definidos no documento.
Como extrair conteúdo com base em estilos
Em um nível simples, recuperar o conteúdo com base em estilos de um documento do Word pode ser útil para identificar, listar e contar parágrafos e execuções de texto formatado com um estilo específico. Por exemplo, pode ser necessário identificar tipos específicos de conteúdo no documento, como exemplos, títulos, referências, palavras-chave, nomes de figuras e estudos de caso.
Indo mais alguns passos, isso também pode ser usado para aproveitar a estrutura do documento, definida pelos estilos que ele usa, para redirecionar o documento para outra saída, como HTML. Na verdade, é assim que a documentação do Aspose é construída, colocando o Aspose.Words à prova. Uma ferramenta criada com Aspose.Words pega os documentos originais do Word e os divide em tópicos em determinados níveis de título. Um arquivo XML é produzido usando Aspose.Words que é usado para construir a árvore de navegação que você pode ver à esquerda. E então o Aspose.Words converte cada tópico em HTML.
A solução para recuperar texto formatado com estilos específicos em um documento do Word é normalmente econômica e direta usando Aspose.Words.
A solução
Para ilustrar a facilidade com que o Aspose.Words lida com a recuperação de conteúdo com base em estilos, vejamos um exemplo. Neste exemplo, recuperaremos texto formatado com um estilo de parágrafo específico e um estilo de caractere de um documento do Word de amostra. Em alto nível, isso envolverá:
- Abrindo um documento Word usando a classe Document.
- Obtendo coleções de todos os parágrafos e todas as execuções do documento.
- Selecionando apenas os parágrafos e execuções necessários. Especificamente, recuperaremos o texto formatado com o estilo de parágrafo ‘Título 1’ e o estilo de caractere ‘Ênfase intensa’ deste exemplo de documento do Word.
Neste documento de amostra, o texto formatado com o estilo de parágrafo ‘Título 1’ é ‘Inserir guia’, ‘Estilos rápidos’ e ‘Tema’, e o texto formatado com o estilo de caractere ‘Ênfase intensa’ são as diversas ocorrências de azul, texto em itálico e em negrito, como ‘galerias’ e ‘aspecto geral’.
O código
A implementação de uma consulta baseada em estilo é bastante simples no modelo de objeto de documento Aspose.Words, pois ele simplesmente utiliza ferramentas que já existem. Dois métodos de classe são implementados para esta solução:
- parágrafos_por_style_name – Este método recupera uma matriz dos parágrafos do documento que possuem um nome de estilo específico.
- run_by_style_name – Este método recupera um array das execuções no documento que possuem um nome de estilo específico. Ambos os métodos são muito semelhantes, as únicas diferenças são os tipos de nós e a representação das informações de estilo dentro do parágrafo e dos nós de execução. Aqui está uma implementação de
paragraphs_by_style_name: Abaixo do exemplo, encontre todos os parágrafos formatados com o estilo especificado.
Esta implementação também utiliza o método Document.get_child_nodes da classe Document, que retorna uma coleção de todos os nós com o tipo especificado, que neste caso em todos os parágrafos.
Observe que o segundo parâmetro do método Document.get_child_nodes está definido como True. Isso força o método Document.get_child_nodes a selecionar todos os nós filhos recursivamente, em vez de selecionar apenas os filhos imediatos.
Também vale ressaltar que a coleção de parágrafos não cria uma sobrecarga imediata porque os parágrafos são carregados nessa coleção somente quando você acessa os itens contidos neles. Então, tudo que você precisa fazer é percorrer a coleção, usando o operador foreach padrão e adicionar parágrafos que tenham o estilo especificado ao array parágrafos_com_estilo. O nome do estilo Paragraph pode ser encontrado na propriedade Style.name do objeto Paragraph.paragraph_format. A implementação do run_by_style_name é quase a mesma, embora obviamente estejamos usando NodeType.RUN para recuperar nós de execução. A propriedade Font.style de um objeto Run é usada para acessar informações de estilo nos nós Run. O exemplo abaixo encontra todas as execuções formatadas com o estilo especificado.
Quando ambas as consultas são implementadas, tudo o que você precisa fazer é passar um objeto de documento e especificar os nomes dos estilos do conteúdo que deseja recuperar: O exemplo abaixo executa consultas e exibe os resultados. Você pode baixar o arquivo de modelo deste exemplo em aqui.
Resultado final
Quando tudo estiver pronto, a execução do exemplo exibirá a seguinte saída:
Como você pode ver, este é um exemplo muito simples, mostrando o número e o texto dos parágrafos coletados e executados no documento Word de amostra.
Copiar todos os estilos do modelo
Há casos em que você deseja copiar todos os estilos de um documento para outro. Você pode usar o método Document.copy_styles_from_template para copiar estilos do modelo especificado para um documento. Quando os estilos são copiados de um modelo para um documento, os estilos com nomes semelhantes no documento são redefinidos para corresponder às descrições de estilo no modelo. Os estilos exclusivos do modelo são copiados para o documento. Os estilos exclusivos do documento permanecem intactos. O exemplo Below code mostra como copiar estilos de um documento para outro.
Como manipular propriedades do tema
Adicionamos API básico em Aspose.Words para acessar as propriedades do tema do documento. Por enquanto, este API inclui os seguintes objetos públicos:
Veja como você pode obter propriedades do tema:
E aqui está como você pode definir as propriedades do tema: