Working with Watermark
This topic discusses how to work programmatically with a watermark using Aspose.Words. A watermark is a background image that displays behind the text in a document. A watermark can contain a text or an image represented by the Watermark class.
How to Add a Watermark to a Document
In Microsoft Word, a watermark can easily be inserted in a document using the Insert Watermark command. Aspose.Words provides the watermark class to add or remove watermark in documents. Aspose.Words provides WatermarkType enumeration defining three possible types of watermarks (Text, Image, and None) to work with.
Add Text Watermark
The following code example demonstrates how to insert a text watermark in a document by defining TextWatermarkOptions using the SetText method.
Add Image Watermark
The following code example demonstrates how to insert an image watermark in a document by defining ImageWatermarkOptions using the SetImage method.
The watermark can also be inserted using shape class as well. It is very easy to insert any shape or image into a header or footer and thus create a watermark of any imaginable type. The following code example inserts a watermark into a Word document.
How to Remove Watermark from a Document
The Watermark class provides the Remove method to remove the watermark from a document. The following code examples demonstrates how to remove a watermark from documents.
To remove the watermark from a document you have to set only the name of the watermark shape during inserting and then remove the watermark shape by an assigned name. The following code snippets show you how to set the name of the watermark shape and remove from the document.
// Set name to be able to remove it afterwards watermark.Name("WaterMark");
How to Add a Watermark in Table Cell
Sometimes you need to insert a watermark/image into a table’s cell and display it outside the table, you can use ShapeBase.IsLayoutInCell property. This property gets or sets a flag indicating whether the shape is displayed inside a table or outside of it. Note that this property works only when you optimize the document for MS Word 2010 using CompatibilityOptions.OptimizeFor method.
The code example givn below shows how to use this property.