Mesclar células da tabela
Às vezes, certas linhas de uma tabela exigem um título ou grandes blocos de texto que ocupam toda a largura da tabela. Para um design adequado da tabela, o usuário pode mesclar várias células da tabela em uma. Aspose.Words oferece suporte a células mescladas ao trabalhar com todos os formatos de entrada, incluindo a importação de conteúdo HTML.
Como mesclar células de tabela
No Aspose.Words, as células mescladas são representadas pelas seguintes propriedades da classe CellFormat:
- HorizontalMerge que descreve se a célula faz parte de uma mesclagem horizontal de células
- VerticalMerge que descreve se a célula faz parte de uma mesclagem vertical de células
Os valores dessas propriedades determinam o comportamento de mesclagem das células:
- A primeira célula de uma sequência de células mescladas terá CellMerge.First
- Quaisquer células mescladas posteriormente terão CellMerge.Previous
- Uma célula que não for mesclada terá CellMerge.None
Verifique se a célula está mesclada
Para verificar se uma célula faz parte de uma sequência de células mescladas, basta verificar as propriedades HorizontalMerge e VerticalMerge.
O exemplo de código a seguir mostra como imprimir o tipo de mesclagem de células horizontal e vertical:
Mesclar células da tabela ao usar o DocumentBuilder
Para mesclar células em uma tabela criada com DocumentBuilder, você precisa definir o tipo de mesclagem apropriado para cada célula onde a mesclagem é esperada – primeiro CellMerge.First e depois CellMerge.Previous.
Além disso, você deve se lembrar de limpar a configuração de mesclagem para as células onde nenhuma mesclagem é necessária – isso pode ser feito definindo a primeira célula sem mesclagem como CellMerge.None. Caso contrário, todas as células da tabela serão mescladas.
O exemplo de código a seguir mostra como criar uma tabela com duas linhas onde as células da primeira linha são mescladas horizontalmente:
O exemplo de código a seguir mostra como criar uma tabela de duas colunas onde as células da primeira coluna são mescladas verticalmente:
Mesclar células da tabela em outros casos
Em outras situações onde o DocumentBuilder não é utilizado, como em uma tabela existente, mesclar células da forma anterior pode não ser tão fácil. Em vez disso, podemos agrupar as operações básicas envolvidas na aplicação de propriedades de mesclagem às células em um método que torna a tarefa muito mais fácil. Este método é semelhante ao método de automação Merge, chamado para mesclar um intervalo de células em uma tabela.
O código abaixo irá mesclar as células da tabela no intervalo especificado, começando na célula fornecida e terminando na célula final. Nesse caso, o intervalo pode abranger várias linhas ou colunas:
O exemplo de código a seguir mostra como mesclar um intervalo de células entre duas células especificadas:
Dependendo da versão do .NET Framework que você está usando, você pode refinar esse método transformando-o em um método de extensão. Nesse caso, você pode chamar esse método diretamente em uma célula para mesclar um intervalo de células, como cell1.Merge(cell2).
Células mescladas verticais e horizontais na tabela HTML
Como dissemos em artigos anteriores, uma tabela em Microsoft Word é um conjunto de linhas independentes. Cada linha possui um conjunto de células que são independentes das células de outras linhas. Assim, na tabela Microsoft Word não existe um objeto como “coluna”, e “1ª coluna” é algo como “o conjunto das 1ª células de cada linha da tabela”. Isto permite aos utilizadores ter uma tabela em que, por exemplo, a 1ª linha é composta por duas células – 2cm e 1cm, e a 2ª linha é composta por duas células diferentes – 1cm e 2cm de largura. E o Aspose.Words suporta esse conceito de tabelas.
Uma tabela em HTML tem uma estrutura essencialmente diferente: cada linha possui o mesmo número de células e (é importante para a tarefa) cada célula possui a largura da coluna correspondente, a mesma para todas as células de uma coluna. Portanto, se HorizontalMerge e VerticalMerge retornarem um valor incorreto, use o seguinte exemplo de código:
Converter em células mescladas horizontalmente
Às vezes não é possível detectar quais células são mescladas porque algumas versões mais recentes do Microsoft Word não usam mais os sinalizadores de mesclagem quando as células são mescladas horizontalmente. Mas para situações em que as células são mescladas horizontalmente em uma célula por sua largura usando sinalizadores de mesclagem, o Aspose.Words fornece o método ConvertToHorizontallyMergedCells para converter células. Este método simplesmente transforma a tabela e adiciona novas células conforme necessário.
O exemplo de código a seguir mostra o método acima em operação: