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 Aspose.Words DOM. Cependant, l’utilisation directe de classes Aspose.Words DOM nécessite généralement plus de lignes de code que l’utilisation de DocumentBuilder.

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 à l’aide de 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. Voir l’article suivant “Navigation avec curseur” pour en savoir plus sur le curseur virtuel.

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, checkbox, 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: