Aplicar estilo de tabela

Um estilo de tabela define um conjunto de formatação que pode ser facilmente aplicado a uma tabela. Formatações como bordas, sombreamento, alinhamento e fonte podem ser definidas em um estilo de tabela e aplicadas a muitas tabelas para obter uma aparência consistente.

Aspose.Words suporta a aplicação de um estilo de tabela a uma tabela e também a leitura de propriedades de qualquer estilo de tabela. Os estilos de tabela são preservados durante o carregamento e salvamento das seguintes maneiras:

  • Os estilos de tabela nos formatos DOCX e WordML são preservados ao carregar e salvar nesses formatos
  • Os estilos de tabela são preservados ao carregar e salvar no formato DOC (mas não em qualquer outro formato)
  • Ao exportar para outros formatos, renderizar ou imprimir, os estilos da tabela são expandidos para formatação direta na tabela, portanto toda a formatação é preservada

Crie um estilo de tabela

O usuário pode criar um novo estilo e adicioná-lo à coleção de estilos. O método Add é usado para criar um novo estilo de tabela.

O exemplo de código a seguir mostra como criar um novo estilo de tabela definido pelo usuário:

Copiar um estilo de tabela existente

Se necessário, você pode copiar um estilo de tabela que já existe em um determinado documento para sua coleção de estilos usando o método AddCopy.

É importante saber que com esta cópia os estilos vinculados também são copiados.

O exemplo de código a seguir mostra como importar um estilo de um documento para outro:

Aplicar um estilo de tabela existente

Aspose.Words fornece um TableStyle herdado da classe Style. TableStyle facilita ao usuário a aplicação de diferentes opções de estilo, como sombreamento, preenchimento, recuo, CellSpacing e Font, etc.

Além disso, Aspose.Words fornece a classe StyleCollection e algumas propriedades da classe Table para especificar com qual estilo de tabela trabalharemos: Style, StyleIdentifier, StyleName e StyleOptions.

Aspose.Words também fornece a classe ConditionalStyle que representa a formatação especial aplicada a alguma área de uma tabela com um estilo de tabela atribuído, e o ConditionalStyleCollection que representa uma coleção de objetos ConditionalStyle. Esta coleção contém um conjunto permanente de itens que representam um item para cada valor do tipo de enumeração ConditionalStyleType. A enumeração ConditionalStyleType define todas as áreas possíveis da tabela para as quais a formatação condicional pode ser definida em um estilo de tabela.

Nesse caso, a formatação condicional pode ser definida para todas as áreas de tabela possíveis definidas no tipo de enumeração ConditionalStyleType.

O exemplo de código a seguir mostra como definir a formatação condicional para a linha de cabeçalho da tabela:

Você também pode escolher em quais partes da tabela aplicar estilos, como primeira coluna, última coluna, linhas com faixas. Eles estão listados na enumeração TableStyleOptions e são aplicados por meio da propriedade StyleOptions. A enumeração TableStyleOptions permite uma combinação bit a bit desses recursos.

O exemplo de código a seguir mostra como criar uma nova tabela com um estilo de tabela aplicado:

As imagens abaixo mostram uma representação do Table Styles em Microsoft Word e suas propriedades correspondentes em Aspose.Words.

formatting-table-style-aspose-words-python

Trabalhando com estilos de tabela

Um estilo de tabela define um conjunto de formatação que pode ser facilmente aplicado a uma tabela. Formatações como bordas, sombreamento, alinhamento e fonte podem ser definidas em um estilo de tabela e aplicadas a muitas tabelas para obter uma aparência consistente.

Aspose.Words suporta a aplicação de um estilo de tabela a uma tabela e também a leitura de propriedades de qualquer estilo de tabela. Os estilos de tabela são preservados durante o carregamento e salvamento das seguintes maneiras:

  • Os estilos de tabela nos formatos DOCX e WordML são preservados ao carregar e salvar nesses formatos.
  • Os estilos de tabela são preservados ao carregar e salvar no formato DOC (mas não em qualquer outro formato).
  • Ao exportar para outros formatos, renderizar ou imprimir, os estilos de tabela são expandidos para formatação direta na tabela para que toda a formatação seja preservada.

Atualmente, não é possível criar novos estilos de tabela. Você só pode aplicar estilos de tabela integrados ou estilos de tabela personalizados que já existem no documento a uma tabela

Pegue a formatação do estilo de tabela e aplique-a como formatação direta

Aspose.Words também fornece o método ExpandTableStylesToDirectFormatting para pegar a formatação encontrada em um estilo de tabela e expandi-la nas linhas e células da tabela como formatação direta. Tente combinar a formatação com o estilo da tabela e o estilo da célula.

O exemplo de código a seguir mostra como expandir a formatação de estilos para linhas e células da tabela como formatação direta:

Formatação de tabela em Python Unir tabelas