Trabalhar com texto numa tabela

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

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

Substituir texto numa tabela

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

A capacidade de utilizar caracteres especiais ao substituir é actualmente suportada, pelo que é possível substituir o texto existente por texto com 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 cadeia de texto nas células de uma tabela inteira:

Extrair texto simples da 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 é utilizada para extrair conteúdo apenas de células de tabelas individuais.

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

Trabalhar com texto de tabela alternativo

Microsoft Word as tabelas têm a table title e 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 de tabela e uma descrição usando as propriedades Title e Description. Estas propriedades são significativas para DOCX documentos em conformidade com o 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 title e description de uma tabela: