Lavorare con il testo in una tabella
Come accennato negli articoli precedenti, una tabella solitamente contiene testo semplice, sebbene nelle celle della tabella sia possibile inserire altri contenuti come immagini o anche altre tabelle.
L’aggiunta di testo o altro contenuto alla tabella viene effettuata utilizzando gli appositi metodi della classe DocumentBuilder ed è descritta nell’articolo “Crea una tabella”. In questo articolo parleremo di come lavorare con il testo in una tabella già esistente.
Sostituisci il testo in una tabella
La tabella, come qualsiasi altro nodo in Aspose.Words, ha accesso all’oggetto Range. Utilizzando l’oggetto intervallo tabella, puoi sostituire il testo in una tabella.
La possibilità di utilizzare caratteri speciali durante la sostituzione è attualmente supportata, quindi è possibile sostituire il testo esistente con testo composto da più paragrafi. Per fare ciò è necessario utilizzare i metacaratteri speciali descritti nel corrispondente metodo Replace.
L’esempio di codice seguente mostra come sostituire tutte le istanze di una stringa di testo nelle celle di un’intera tabella:
Estrai testo semplice da una tabella o da una cella
Utilizzando l’oggetto Range, puoi anche chiamare metodi sull’intero intervallo di tabelle ed estrarre la tabella come testo semplice. A tale scopo, utilizzare la proprietà Text
L’esempio di codice seguente mostra come stampare l’intervallo di testo di una tabella:
La stessa tecnica viene utilizzata per estrarre il contenuto solo dalle singole celle della tabella.
L’esempio di codice seguente mostra come stampare un intervallo di testo di elementi di riga e tabella:
Lavorare con testo di tabella alternativo
Le tabelle Microsoft Word hanno un formato table title e table description che forniscono una rappresentazione testuale alternativa delle informazioni contenute nella tabella.
In Aspose.Words è anche possibile aggiungere un titolo e una descrizione alla tabella utilizzando le proprietà Title e Description. Queste proprietà sono significative per i documenti DOCX conformi a ISO/IEC 29500. Quando si salvano in formati precedenti a ISO/IEC 29500, queste proprietà vengono ignorate.
L’esempio di codice seguente mostra come impostare le proprietà titolo e descrizione di una tabella: