Travailler avec un filigrane

Cette rubrique explique comment utiliser par programmation un filigrane à l’aide de Aspose.Words. Un filigrane est une image d’arrière-plan qui s’affiche derrière le texte d’un document. Un filigrane peut contenir un texte ou une image représentée par la classe Watermark.

Comment ajouter un filigrane à un document

Dans Microsoft Word, un filigrane peut facilement être inséré dans un document à l’aide de la commande Insérer un filigrane. Aspose.Words fournit la classe Watermark pour ajouter ou supprimer un filigrane dans les documents. Aspose.Words fournit l’énumération WatermarkType définissant trois types possibles de filigranes (TEXT, IMAGE et NONE) avec lesquels travailler

Ajouter un filigrane de texte

L’exemple de code suivant montre comment insérer un filigrane de texte dans un document en définissant TextWatermarkOptions à l’aide de la méthode set_text.

Ajouter un filigrane d’image

L’exemple de code suivant montre comment insérer un filigrane d’image dans un document en définissant ImageWatermarkOptions à l’aide de la méthode set_image:

Le filigrane peut également être inséré à l’aide de la classe de forme. Il est très simple d’insérer n’importe quelle forme ou image dans un en-tête ou un pied de page et ainsi de créer un filigrane de tout type imaginable.

L’exemple de code suivant insère un filigrane dans un document Word:

Supprimer le filigrane d’un document

La classe Watermark fournit la méthode Remove pour supprimer le filigrane d’un document.

L’exemple de code suivant montre comment supprimer un filigrane des documents:

Si les filigranes sont ajoutés à l’aide de l’objet de classe Shape, pour supprimer le filigrane d’un document, vous devez définir uniquement le nom de la forme du filigrane lors de l’insertion, puis supprimer la forme du filigrane en lui attribuant un nom.

L’exemple de code suivant vous montre comment définir le nom de la forme du filigrane et la supprimer du document:

# Set name to be able to remove it afterwards
watermark.name = "WaterMark"

Ajouter un filigrane dans une cellule de tableau

Parfois, vous devez insérer un filigrane/une image dans la cellule d’un tableau et l’afficher en dehors du tableau, vous pouvez utiliser la propriété is_layout_in_cell. Cette propriété obtient ou définit un indicateur indiquant si la forme est affichée à l’intérieur ou à l’extérieur d’un tableau. Notez que cette propriété ne fonctionne que lorsque vous optimisez le document pour Microsoft Word 2010 à l’aide de la méthode optimize_for.

L’exemple de code suivant montre comment utiliser cette propriété: