Trabalhar com texto em uma tabela

Conforme mencionado em artigos anteriores, uma tabela geralmente contém texto simples, embora outros conteúdos, como imagens ou mesmo outras tabelas, possam ser colocados nas células da tabela.

A adição de texto ou outro conteúdo à tabela é realizada usando os métodos apropriados da classe DocumentBuilder e é descrita no artigo “Criar uma mesa”. Neste artigo falaremos sobre como trabalhar com texto em uma tabela já existente.

Substituir texto em uma tabela

A tabela, como qualquer outro nó Aspose.Words, tem acesso ao objeto Range. Usando o objeto de intervalo de tabela, você pode substituir texto em uma tabela.

A capacidade de usar caracteres especiais ao substituir é atualmente suportada, portanto é possível substituir o texto existente por texto de vários parágrafos. Para fazer isso, você precisa usar os metacaracteres especiais descritos no método Replace correspondente.

O exemplo de código a seguir mostra como substituir todas as instâncias de uma sequência de texto nas células de uma tabela inteira:

Extraia texto simples de tabela ou célula

Usando o objeto Range, você também pode chamar métodos em todo o intervalo da tabela e extrair a tabela como texto simples. Para fazer isso, use a propriedade Text

O exemplo de código a seguir mostra como imprimir o intervalo de texto de uma tabela:

A mesma técnica é usada para extrair conteúdo apenas de células individuais da tabela.

O exemplo de código a seguir mostra como imprimir um intervalo de texto de elementos de linha e tabela:

Trabalhando com texto de tabela alternativo

As tabelas Microsoft Word possuem um table title e um table description que fornecem uma representação textual alternativa das informações contidas na tabela.

Em Aspose.Words, você também pode adicionar um título e uma descrição de tabela usando as propriedades Title e Description. Essas propriedades são significativas para documentos DOCX em conformidade com ISO/IEC 29500. Ao salvar em formatos anteriores a ISO/IEC 29500, essas propriedades são ignoradas.

O exemplo de código a seguir mostra como definir as propriedades de título e descrição de uma tabela: