Travailler avec du texte dans un tableau
Comme mentionné dans les articles précédents, un tableau contient généralement du texte brut, bien que d’autres contenus tels que des images ou même d’autres tableaux puissent être placés dans les cellules du tableau.
L’ajout de texte ou d’un autre contenu au tableau s’effectue à l’aide des méthodes appropriées de la classe DocumentBuilder et est décrit dans l’article “Créer un tableau”. Dans cet article, nous expliquerons comment travailler avec du texte dans un tableau déjà existant.
Remplacer du texte dans un tableau
La table, comme tout autre nœud dans Aspose.Words, a accès à l’objet Range. À l’aide de l’objet plage de tableau, vous pouvez remplacer du texte dans un tableau.
La possibilité d’utiliser des caractères spéciaux lors du remplacement est actuellement prise en charge, il est donc possible de remplacer le texte existant par du texte multi-paragraphes. Pour ce faire, vous devez utiliser les métacaractères spéciaux décrits dans la méthode Replace correspondante.
L’exemple de code suivant montre comment remplacer toutes les instances d’une chaîne de texte dans les cellules d’un tableau entier:
Extraire le texte brut d’un tableau ou d’une cellule
À l’aide de l’objet Range, vous pouvez également appeler des méthodes sur toute la plage du tableau et extraire le tableau sous forme de texte brut. Pour ce faire, utilisez la propriété Text
L’exemple de code suivant montre comment imprimer la plage de texte d’un tableau:
La même technique est utilisée pour extraire le contenu des cellules individuelles du tableau uniquement.
L’exemple de code suivant montre comment imprimer une plage de texte d’éléments de ligne et de tableau:
Utilisation d’un texte de tableau alternatif
Les tableaux Microsoft Word ont un table title et un table description qui fournissent une représentation textuelle alternative des informations contenues dans le tableau.
Dans Aspose.Words, vous pouvez également ajouter un titre et une description de tableau à l’aide des propriétés Title et Description. Ces propriétés sont significatives pour les documents DOCX conformes à ISO/IEC 29500. Lors de l’enregistrement dans des formats antérieurs à ISO/IEC 29500, ces propriétés sont ignorées.
L’exemple de code suivant montre comment définir les propriétés de titre et de description d’une table: