PageWatermark
This topic is not current. For the most current information, see the Print Schema Specification.
Describes the watermark setting of the output and the watermark characteristics. Watermarks apply to the logical page, not the physical page. For example, if DocumentDuplex is enabled, a watermark will appear on each NUp page on each sheet. If DocumentDuplex, PagesPerSheet=2, then each sheet will have 2 watermarks.
Element Information
Name | Value |
---|---|
Element Type |
Feature |
Scoping Prefix |
Page |
Notes |
Coordinates are relative to PageImageableSize, where the origin of the watermark is relative to the origin of the PageImageableSize. |
Structural Content
The XML structure of this element is as follows:
<psf:Feature name="psk:PageWatermark">
<psf:Property name="psf:SelectionType">
<psf:Value xsi:type="xs:string">psk:PickOne</psf:Value>
</psf:Property>
<psf:Option name="psk:_OptionName_">
<psf:Property name="psf:IdentityOption">
<psf:Value xsi:type="xs:string">_IdentityOptionValue_</psf:Value>
</psf:Property>
<!-- Defines the width origin of the watermark. See the PageWatermarkOriginWidth ParameterDefinition for more information. -->
<psf:ScoredProperty name="psk:OriginWidth">
<psf:ParameterRef name="psk:PageWatermarkOriginWidth" />
</psf:ScoredProperty>
<!-- Defines the height origin of the watermark. See the PageWatermarkOriginHeight ParameterDefinition for more information. -->
<psf:ScoredProperty name="psk:OriginHeight">
<psf:ParameterRef name="psk:PageWatermarkOriginHeight" />
</psf:ScoredProperty>
<!-- Defines the transparency value of the watermark. Transparency should be applied to all content, including transparent content. See the PageWatermarkTransparency ParameterDefinition for more information. -->
<psf:ScoredProperty name="psk:Transparency">
<psf:ParameterRef name="psk:PageWatermarkTransparency" />
</psf:ScoredProperty>
<!-- Defines the angle value of the watermark. See the PageWatermarkAngle ParameterDefinition for more information. -->
<psf:ScoredProperty name="psk:Angle">
<psf:ParameterRef name="psk:PageWatermarkAngle" />
</psf:ScoredProperty>
<!-- Applicable to options that include bitmaps. -->
<!-- Specifies the text font color -->
<!-- Applicable to options that include text. Defines the sRGB color for the watermark text. Format is ARGB: #AARRGGBB. -->
<psf:ScoredProperty name="psk:FontColor">
<psf:ParameterRef name="psk:PageWatermarkTextColor" />
</psf:ScoredProperty>
<!-- Applicable to options that include text. Defines the available font sizes for the watermark text. Measured in points.-->
<psf:ScoredProperty name="psk:FontSize">
<psf:ParameterRef name="psk:PageWatermarkTextFontSize" />
</psf:ScoredProperty>
<!-- Applicable to options that include text. Defines the text to be displayed in the watermark. -->
<psf:ScoredProperty name="psk:Text">
<psf:ParameterRef name="psk:PageWatermarkTextText" />
</psf:ScoredProperty>
</psf:Option>
<!--Defines the layering behavior of the watermark. -->
<psf:Feature name="psk:Layering">
<!-- Watermark appears over page content. -->
<psf:Option name="psk:Overlay" />
<!-- Watermark appear under page content. -->
<psf:Option name="psk:Underlay" />
</psf:Feature>
</psf:Feature>
Structure Variables
The following table outlines the characteristics of the variables defined in the XML structure.
Name | Data type | Unit | Supported values | Summary |
---|---|---|---|---|
_OptionName_ |
string |
characters |
Valid fully qualified name as defined by Namespaces in XML. If no namespace is specified, default namespace is assumed. |
The name of the option. |
_IdentityOptionValue_ |
string |
n/a |
True, False. |
Defines an Option which when selected would disable this feature. |
Extensible Markup Language (XML) Content
The public Print Schema keywords are defined in the https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords
namespace. The public Extensible Markup Language (XML) content for this keyword is defined below:
<psf:Feature name="psk:PageWatermark">
<psf:Property name="psf:SelectionType">
<psf:Value xsi:type="xs:string">psk:PickOne</psf:Value>
</psf:Property>
<!-- Specifies a text only watermark -->
<psf:Option name="psk:Text">
<psf:Property name="psf:IdentityOption">
<psf:Value xsi:type="xs:string">True</psf:Value>
</psf:Property>
<psf:ScoredProperty name="psk:OriginWidth">
<psf:ParameterRef name="psk:PageWatermarkOriginWidth" />
</psf:ScoredProperty>
<psf:ScoredProperty name="psk:OriginHeight">
<psf:ParameterRef name="psk:PageWatermarkOriginHeight" />
</psf:ScoredProperty>
<psf:ScoredProperty name="psk:FontColor">
<psf:ParameterRef name="psk:PageWatermarkTextColor" />
</psf:ScoredProperty>
<psf:ScoredProperty name="psk:FontSize">
<psf:ParameterRef name="psk:PageWatermarkTextFontSize" />
</psf:ScoredProperty>
<psf:ScoredProperty name="psk:Text">
<psf:ParameterRef name="psk:PageWatermarkTextText" />
</psf:ScoredProperty>
<psf:ScoredProperty name="psk:Transparency">
<psf:ParameterRef name="psk:PageWatermarkTransparency" />
</psf:ScoredProperty>
<psf:ScoredProperty name="psk:Angle">
<psf:ParameterRef name="psk:PageWatermarkTextAngle" />
</psf:ScoredProperty>
</psf:Option>
<psf:Feature name="psk:Layering">
<!--Specifies Overlay Layering-->
<psf:Option name="psk:Overlay" />
<!--Specifies Underlay Layering-->
<psf:Option name="psk:Underlay" />
</psf:Feature>
</psf:Feature>