How to: Add Different Watermarks to Document Pages

• Jun 21, 2019
• 2 minutes to read

The following example demonstrates how to specify a unique watermark for different pages in a report. For this you need to call the Page.AssignWatermark method for the page whose watermark needs to be changed, and pass a new watermark to this method as a parameter, as shown below. If you need to remove a watermark from a particular page, pass a new empty watermark to the AssignWatermark method.

C#

using System;
using System.Drawing;
using System.Windows.Forms;
using DevExpress.XtraPrinting;
using DevExpress.XtraPrinting.Drawing;
// ...

private void button1_Click(object sender, EventArgs e) {
    // Create a report and assign a watermark to it.
    XtraReport1 report = new XtraReport1();
    report.Watermark.CopyFrom(CreateTextWatermark("Common Watermark"));
    report.CreateDocument();

    // Add a custom watermark to the second page.
    Page myPage = report.Pages[1];
    myPage.AssignWatermark(CreateTextWatermark("Second Page"));

    // Remove a watermark from the third page.
    myPage = report.Pages[2];
    myPage.AssignWatermark(new PageWatermark());

    // Show the Print Preview.
    report.ShowPreviewDialog();
}

// Create a watermark with the specified text.
private Watermark CreateTextWatermark(string text) {
    Watermark textWatermark = new Watermark();

    textWatermark.Text = text;
    textWatermark.TextDirection = DirectionMode.ForwardDiagonal;
    textWatermark.Font = new Font(textWatermark.Font.FontFamily, 40);
    textWatermark.ForeColor = Color.DodgerBlue;
    textWatermark.TextTransparency = 150;
    textWatermark.ShowBehind = false;

    return textWatermark;
}

VB.NET

Imports System
Imports System.Drawing
Imports System.Windows.Forms
Imports DevExpress.XtraPrinting
Imports DevExpress.XtraPrinting.Drawing
' ...

Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
Handles Button1.Click
    ' Create a report and assign a watermark to it.
    Dim report As XtraReport1 = New XtraReport1()
    report.Watermark.CopyFrom(CreateTextWatermark("Common Watermark"))
    report.CreateDocument()

    ' Add a custom watermark to the second page.
    Dim myPage As Page = report.Pages(1)
    myPage.AssignWatermark(CreateTextWatermark("Second Page"))

    ' Remove a watermark from the third page.
    myPage = report.Pages(2)
    myPage.AssignWatermark(New PageWatermark())

    report.ShowPreviewDialog()
End Sub

' Create a watermark with the specified text.
Private Function CreateTextWatermark(ByVal text As String) As Watermark
    Dim textWatermark As Watermark = New Watermark()

    textWatermark.Text = text
    textWatermark.TextDirection = DirectionMode.ForwardDiagonal
    textWatermark.Font = New Font(textWatermark.Font.FontFamily, 40)
    textWatermark.ForeColor = Color.DodgerBlue
    textWatermark.TextTransparency = 150
    textWatermark.ShowBehind = False

    Return textWatermark
End Function

Tip

A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=E109.