Présentation du Générateur de Documents
DocumentBuilder est une classe puissante qui s’associe à Document et vous permet de créer des documents dynamiques à partir de zéro ou d’ajouter de nouveaux éléments à un document existant.
DocumentBuilder
Générateur de documents ou Aspose.Words DOM
DocumentBuilder
Les opérations possibles avec DocumentBuilder sont également possibles lors de l’utilisation directe des classes du DOM Aspose.Words. Cependant, l’utilisation directe des classes DOM Aspose.Words nécessite généralement plus de lignes de code que l’utilisation de DocumentBuilder.
Navigation dans les Documents
La navigation dans le document est basée sur le concept d’un curseur virtuel, avec lequel vous pouvez vous déplacer vers un autre emplacement du document en utilisant diverses méthodes DocumentBuilder.MoveToXXX telles que MoveToDocumentStart et MoveToField. Ce curseur virtuel indique où le texte sera inséré lors de l’appel des méthodes Write, Writeln, InsertBreak, et d’autres.
L’exemple de code suivant montre comment accéder à un signet:
Création et Modification de Documents
Aspose.Words API fournit plusieurs classes qui sont responsables de la mise en forme de divers éléments d’un document. Chacune des classes encapsule les propriétés de mise en forme liées à un élément de document spécifique, tel que du texte, un paragraphe, une section, etc. Par exemple, la classe Font représente les propriétés de formatage des caractères, la classe ParagraphFormat représente les propriétés de formatage des paragraphes, et ainsi de suite. Les objets de ces classes sont renvoyés par les propriétés DocumentBuilder correspondantes, qui ont les mêmes noms que les classes. Par conséquent, vous pouvez y accéder et définir le formatage souhaité lors de la construction du document.
Vous pouvez également insérer du texte, une case à cocher, un objet ole, des images, des signets, des champs de formulaire et d’autres éléments de document à la position du curseur à l’aide de la méthode Write ou de l’une des méthodes DocumentBuilder.InsertXXX, telles que InsertField, InsertHtml et méthodes similaires.
Voyons comment créer un document simple en utilisant le DocumentBuilder.
Créer un document en utilisant DocumentBuilder
Pour commencer, vous devez créer un DocumentBuilder et l’associer à un objet Document. Vous créez une nouvelle instance de DocumentBuilder en appelant son constructeur et la transmettez à un objet Document pour l’attacher au constructeur.
Pour insérer un texte, transmettez la chaîne de texte que vous devez insérer dans le document à la méthode Write.
L’exemple de code suivant montre comment créer un document simple à l’aide d’un générateur de documents.
Spécifier Le Formatage Du Document
La propriété Font définit la mise en forme du texte. Cet objet contient différents attributs de police (nom de la police, taille de la police, couleur, etc.). Certains attributs de police importants sont également représentés par des propriétés DocumentBuilder pour vous permettre d’y accéder directement. Ce sont les propriétés booléennes Font.Bold, Font.Italic et Font.Underline.
L’exemple de code suivant montre comment insérer un texte formaté à l’aide de DocumentBuilder:
- Font spécifie la mise en forme des caractères qui sera appliquée à tout le texte inséré à partir de la position actuelle dans le document.
- ParagraphFormat spécifie la mise en forme du paragraphe pour le paragraphe actuel et tous les paragraphes à insérer.
- PageSetup spécifie les propriétés de la page et de la section pour la section actuelle et la section entière qui sera insérée.
- CellFormat et RowFormat spécifient les propriétés de mise en forme qui seront appliquées aux cellules et lignes du tableau à partir de la position actuelle dans le document.
Dans cette situation, “actuel” désigne la position, le paragraphe, la section, la cellule ou la ligne dans laquelle se trouve le curseur.