PageWatermark.ImageTransparency Property

Gets or sets the transparency of the watermark's image.

Namespace: DevExpress.XtraPrinting.Drawing

Assembly: DevExpress.Printing.v20.1.Core.dll

Declaration

[DefaultValue(0)]
public int ImageTransparency { get; set; }
<DefaultValue(0)>
Public Property ImageTransparency As Integer

Property Value

Type Default Description
Int32

0

An integer value specifying the images's transparency. It should be between 0 and 255, inclusive.

Remarks

This property specifies the watermark image's transparency. Use the PageWatermark.Image property to access the watermark image.

NOTE

Transparency is not supported for SVG image watermarks. The ImageTransparency property's value is ignored when you set an SVG file as a watermark image.

Examples

This example demonstrates how to add a text watermark (the SetTextWatermark method) or an image watermark (the SetPictureWatermark method) to a printing system document.

using System.Drawing;
using DevExpress.XtraPrinting;
using DevExpress.XtraPrinting.Drawing;
// ...
public void SetTextWatermark(PrintingSystem ps) {
    // Create the text watermark.
    Watermark textWatermark = new Watermark();

    // Set watermark options.
    textWatermark.Text = "CUSTOM WATERMARK TEXT";
    textWatermark.TextDirection = DirectionMode.ForwardDiagonal;
    textWatermark.Font = new Font(textWatermark.Font.FontFamily, 40);
    textWatermark.ForeColor = Color.DodgerBlue;
    textWatermark.TextTransparency = 150;
    textWatermark.ShowBehind = false;
    textWatermark.PageRange = "1,3-5";

    // Set the watermark to a document.
    ps.Watermark.CopyFrom(textWatermark);
}
public void SetPictureWatermark(PrintingSystem ps) {
    // Create the text watermark.
    Watermark pictureWatermark = new Watermark();

    // Set watermark options.
    pictureWatermark.ImageSource = ImageSource.FromFile("Watermark.png");
    pictureWatermark.ImageAlign = ContentAlignment.TopCenter;
    pictureWatermark.ImageTiling = false;
    pictureWatermark.ImageViewMode = ImageViewMode.Stretch;
    pictureWatermark.ImageTransparency = 150;
    pictureWatermark.ShowBehind = true;
    pictureWatermark.PageRange = "2,4";

    // Set the watermark to a document.
    ps.Watermark.CopyFrom(pictureWatermark);
}
See Also