The SetWatermarkEx method is used to configure the printer to print a watermark message on all pages of a document from an external file.
System.Int32 SetWatermarkEx(System.String Watermark, System.String FontName, System.Int16 FontSize, System.Int16 Orientation, System.Int32 Color, System.Int32 HorzPos, System.Int32 VertPos, System.Int32 Options, System.String szFileName)
long SetWatermarkEx( HANDLE hPrinter, LPCSTR szWatermark, LPCSTR szFont, short fontSize, short Orientation, COLORREF color, LONG xPos, LONG yPos, LONG Options, LPCSTR szFileName)
long SetWatermarkExW( HANDLE hPrinter, LPCWSTR szWatermark, LPCWSTR szFont, short fontSize, short Orientation, COLORREF color, LONG xPos, LONG yPos, LONG Options, LPCWSTR szFileName)
Watermark, szWatermark
Text to print on each page. It should be an Ansi string for SetWatermarkEx or a Unicode string for SetWatermarkExW.
FontName, szFont
Font name used to print text.
FontSize, fontSize
Font size in 0.1 inch units.
Orientation
Text orientation in 0.1 degree units.
Color, color
RGB value for watermark color.
HorzPos, xPos
Horizontal text position in 0.1 inch units. This a positive value measured from the left of the page and should take into account the minimum printer margin.
VertPos, yPos
Vertical text position in 0.1 inch units. This a negative value measured from the top of the page and should take into account the minimum printer margin.
Options
Options for the watermark.
Options |
Value (Hex) |
Value (Dec)* |
Description |
---|---|---|---|
WATERMARK_OPTION_FOREGROUND |
0x000001 |
1 |
Watermark is on the top of the document |
WATERMARK_OPTION_RESERVED |
0x000002 |
2 |
It is always set to 0. |
WATERMARK_OPTION_FILE |
0x000004 |
4 |
The watermak is in the file pointed to by szFilename. |
WATERMARK_OPTION_FIRSTPAGEONLY |
0x000008
|
8 |
Place the watermark on the first page only. |
WATERMARK_OPTION_OUTLINE |
0x000010 |
16 |
Format the text to be outline. |
WATERMARK_OPTION_ITALIC |
0x000020 |
32 |
Format the text to be italic. |
WATERMARK_OPTION_UNDERLINE |
0x000040 |
64 |
Format the text to be underlined. |
(*) NOTE: Converting from HEX DWORD, unsigned and 32-bit unit of data
szFileName
Full path of the file to use.
hPrinter
Handle to printer returned by any of the DriverInit function calls.
Returns Value 1 if the method succeeds, 0 otherwise.
This method only sets the watermark parameters for the printer, to actually print watermarks on a document, the option PrintWatermark (Hex 40) should be added to the FileNameOptionsEx property.
This method can be called anytime before or while printing a document to modify the watermarks settings.
To print watermark on specific pages only, e.g. the first page only, the printer events can be captured and the watermark parameters modified while the document is being printed.
Member of CDIntfEx.CDIntfEx.
<Flags()>
Public Enum acFileNameOptions As Integer
' Please check FileNameOptions for the complete flags version
NoPrompt = &H1
UseFileName = &H2
Concatenate = &H4
DisableCompression = &H8
EmbedFonts = &H10
BroadcastMessages = &H20
PrintWatermark = &H40
End Enum
Public Sub Sample()
' Constants for Activation codes
Const strLicenseTo As String = "Amyuni PDF Converter Evaluation"
Const strActivationCode As String = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA"
Const AMYUNIPRINTERNAME As String = "Amyuni PDF Converter"
' Declare a new cdintfex object if it does not exist in the form.
Dim PDF As New CDIntfEx.CDIntfEx
' Get a reference to the installed printer.
' This will fail if the printer name passed to the DriverInit method is
' not found in the printer’s folder
PDF.DriverInit(AMYUNIPRINTERNAME)
' The SetDefaultPrinter function sets the system default printer to the one
' initialized by the DriverInit functions.
PDF.SetDefaultPrinter()
' The EnablePrinter() method needs to be called right before each print job.
' and before the configuration
' Calling the EnablePrinter() method will start a 20 second time-out value
PDF.EnablePrinter(strLicenseTo, strActivationCode)
' Resulting PDF document stored here
PDF.DefaultDirectory = "C:\Temp"
' Set Printer options
PDF.FileNameOptionsEx = acFileNameOptions.NoPrompt Or acFileNameOptions.PrintWatermark
' Set Watermark
PDF.SetWatermarkEx("Property of Amyuni", "Arial", 36, 0, &HD4AF37, 0, -100, 4, @"c:\temp\watermark.txt")
' The BatchConvert method converts a number of files to PDF.
PDF.BatchConvert("C:\Temp\*.docx")
' The RestoreDefaultPrinter function resets the system default printer
' to the printer that was the default before the call to SetDefaultPrinter.
PDF.RestoreDefaultPrinter()
' This function will simply detach from an existing printer because the handle was created using DriverInit
PDF.DriverEnd()
' Destroy PDF object
PDF = Nothing
End Sub
[Flags]
public enum acFileNameOptions
{
// Please check FileNameOptions for the complete flags version
NoPrompt = 0x00000001,
UseFileName = 0x00000002,
Concatenate = 0x00000004,
DisableCompression = 0x00000008,
EmbedFonts = 0x00000010,
BroadcastMessages = 0x00000020,
PrintWatermark = 0x00000040
}
public void Sample()
{
// Constants for Activation codes
const string strLicenseTo = "Amyuni PDF Converter Evaluation";
const string strActivationCode = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA";
const string AMYUNIPRINTERNAME = "Amyuni PDF Converter";
// Declare a new cdintfex object if it does not exist in the form.
CDIntfEx.CDIntfEx PDF = new CDIntfEx.CDIntfEx();
// Get a reference to the installed printer.
// This will fail if the printer name passed to the DriverInit method is
// not found in the printer’s folder
PDF.DriverInit(AMYUNIPRINTERNAME);
// The SetDefaultPrinter function sets the system default printer to the one
// initialized by the DriverInit functions.
PDF.SetDefaultPrinter();
// The EnablePrinter() method needs to be called right before each print job.
// and before the configuration
// Calling the EnablePrinter() method will start a 20 second time-out value
PDF.EnablePrinter(strLicenseTo, strActivationCode);
// Resulting PDF document stored here
PDF.DefaultDirectory = @"C:\Temp";
// Set Printer options
PDF.FileNameOptionsEx = (int)(acFileNameOptions.NoPrompt | acFileNameOptions.PrintWatermark);
// Set Watermark
PDF.SetWatermarkEx("Property of Amyuni", "Arial", 36, 0, &HD4AF37, 0, -100, 4, @"c:\temp\watermark.txt");
// The BatchConvert method converts a number of files to PDF.
PDF.BatchConvert(@"C:\Temp\*.docx");
// The RestoreDefaultPrinter function resets the system default printer
// to the printer that was the default before the call to SetDefaultPrinter.
PDF.RestoreDefaultPrinter();
// This function will simply detach from an existing printer because the handle was created using DriverInit
PDF.DriverEnd();
}
// PDF Converter Cpp.cpp : Defines the entry point for the console application.
//
# include <Windows.h>
# include <string>
# include <iostream>
# include "CdIntf.h"
# pragma comment (lib, "CDIntf.lib")
using namespace std;
int main()
{
// Constants for Activation codes
#define strLicenseTo "Amyuni PDF Converter Evaluation"
#define strActivationCode "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA"
#define AMYUNIPRINTERNAME "Amyuni PDF Converter"
// Get a reference to the installed printer.
// This will fail if the printer name passed to the DriverInit method is
// not found in the printer’s folder
HANDLE PDF = DriverInit(AMYUNIPRINTERNAME);
// The CDISetDefaultPrinter function sets the system default printer to the one
// initialized by the DriverInit functions.
CDISetDefaultPrinter(PDF);
// The EnablePrinter() method needs to be called right before each print job.
// and before the configuration
// Calling the EnablePrinter() method will start a 20 second time-out value
EnablePrinter(PDF, strLicenseTo, strActivationCode);
// Resulting PDF document stored here
SetDefaultDirectory(PDF, "C:\temp");
// Set Printer options
SetFileNameOptions(PDF, NoPrompt | PrintWatermark);
// Set Watermark
SetWatermarkEx(PDF, "Property of Amyuni", "Arial", 36, 0, &HD4AF37, 0, -100, 4, @"c:\temp\watermark.txt");
// The BatchConvert method converts a number of files to PDF.
BatchConvertEx(PDF, "C:\temp\\*.docx");
// The RestoreDefaultPrinter function resets the system default printer
// to the printer that was the default before the call to SetDefaultPrinter.
RestoreDefaultPrinter(PDF);
// This function will simply detach from an existing printer because the handle was created using DriverInit
DriverEnd(PDF);
// Destroy PDF object
PDF = nullptr;
return 0;
}
package Example;
import com.jacob.activeX.ActiveXComponent;
import com.jacob.com.Dispatch;
public class Sample {
public enum acFileNameOptions
{
// Please check FileNameOptions for the complete flags version
NoPrompt(0x00000001),
UseFileName(0x00000002),
Concatenate(0x00000004),
DisableCompression(0x00000008),
EmbedFonts(0x00000010),
BroadcastMessages(0x00000020),
PrintWatermark(0x00000040);
public int value;
public acFileNameOptions(int value)
{
this.value = value;
}
public Object value(){
return value;
}
}
public static void main(String[] args)
{
// Constants for Activation codes
String strLicenseTo = "Amyuni PDF Converter Evaluation";
String strActivationCode = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA";
String AMYUNIPRINTERNAME = "Amyuni PDF Converter";
// Declare a new cdintfex object if it does not exist in the form.
ActiveXComponent pdf = new ActiveXComponent("CDIntfEx.CDIntfEx.6.5");
// Get a reference to the installed printer.
// This will fail if the printer name passed to the DriverInit method is
// not found in the printer’s folder
Dispatch.call(pdf,"DriverInit",AMYUNIPRINTERNAME);
// The SetDefaultPrinter function sets the system default printer to the one
// initialized by the DriverInit functions.
Dispatch.call(pdf,"SetDefaultPrinter");
// The EnablePrinter() method needs to be called right before each print job.
// and before the configuration
// Calling the EnablePrinter() method will start a 20 second time-out value
Dispatch.call(pdf,"EnablePrinter", strLicenseTo, strActivationCode);
// Resulting PDF document stored here
Dispatch.put(pdf,"DefaultDirectory","C:\temp");
// Set Printer options
Dispatch.put(pdf,"FileNameOptionsEx",acFileNameOptions.NoPrompt.value | acFileNameOptions.PrintWatermark.value );
// Set Watermark
Dispatch.call(pdf,"SetWatermark","Property of Amyuni", "Arial", 36, 0, 0xD4AF37, 0, -100, 0);
Dispatch.call(pdf,"SetWatermarkEx","Property of Amyuni", "Arial", 36, 0, &HD4AF37, 0, -100, 4, @"c:\temp\watermark.txt");
// The BatchConvert method converts a number of files to PDF.
Dispatch.call(pdf,"BatchConvert","C:\temp\\*.docx");
// The RestoreDefaultPrinter function resets the system default printer
// to the printer that was the default before the call to SetDefaultPrinter.
Dispatch.call(pdf,"RestoreDefaultPrinter");
// This function will simply detach from an existing printer because the handle was created using DriverInit
Dispatch.call(pdf,"DriverEnd");
// Destroy PDF object
pdf = null;
}
}
$acFileNameOptions = @{
NoPrompt = 0x00000001
UseFileName = 0x00000002
Concatenate = 0x00000004
DisableCompression = 0x00000008
EmbedFonts = 0x00000010
BroadcastMessages = 0x00000020
PrintWatermark = 0x00000040
}
# Please check FileNameOptions for the complete flags version
# Constants for Activation codes
$strLicenseTo = "Amyuni PDF Converter Evaluation"
$strActivationCode = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA"
$AMYUNIPRINTERNAME = "Amyuni PDF Converter"
# Declare a new cdintfex object if it does not exist in the form.
$PDF = New-Object -ComObject CDIntfEx.CDIntfEx.6.5
# Get a reference to the installed printer.
# This will fail if the printer name passed to the DriverInit method is
# not found in the printer’s folder
[System.__ComObject].InvokeMember('DriverInit', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF,$AMYUNIPRINTERNAME)
# The SetDefaultPrinter function sets the system default printer to the one
# initialized by the DriverInit functions.
[System.__ComObject].InvokeMember('SetDefaultPrinter', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF,$null)
# The EnablePrinter()method needs to be called right before each print job.
# and before the configuration
# Calling the EnablePrinter()method will start a 20 second time-out value
[System.__ComObject].InvokeMember('EnablePrinter', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF, @($strLicenseTo, $strActivationCode))
# Resulting PDF document stored here
[System.__ComObject].InvokeMember('DefaultDirectory', [System.Reflection.BindingFlags]::SetProperty,$null,$PDF,"C:\Temp")
# Set Printer options
[System.__ComObject].InvokeMember('FileNameOptionsEx', [System.Reflection.BindingFlags]::SetProperty,$null,$PDF,$acFileNameOptions::NoPrompt -bOr $acFileNameOptions::PrintWatermark)
# Set Watermark
[System.__ComObject].InvokeMember('SetWatermarkEx', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF, @("Property of Amyuni", "Arial", 36, 0, &HD4AF37, 0, -100, 4, @"c:\temp\watermark.txt"))
# The BatchConvert method converts a number of files to PDF.
[System.__ComObject].InvokeMember('BatchConvert', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF, "C:\Temp\*.docx")
# The RestoreDefaultPrinter function resets the system default printer
# to the printer that was the default before the call to SetDefaultPrinter.
[System.__ComObject].InvokeMember('RestoreDefaultPrinter', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF,$null)
# This function will simply detach from an existing printer because the handle was created using DriverInit
[System.__ComObject].InvokeMember('DriverEnd', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF,$null)
# Destroy PDF object
$PDF = $null
' FileNameOptions constants
' Please check FileNameOptions for the complete flags version
Const NoPrompt = &H1
Const UseFileName = &H2
Const Concatenate = &H4
Const DisableCompression = &H8
Const EmbedFonts = &H10
Const BroadcastMessages = &H20
Const PrintWatermark = &H40
Const MultilingualSupport = &H80
Const EncryptDocument = &H100
Const FullEmbed = &H200
' Constants for Activation codes
Const strLicenseTo = "Amyuni PDF Converter Evaluation"
Const strActivationCode = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA"
Const AMYUNIPRINTERNAME = "Amyuni PDF Converter"
' Declare a new cdintfex object
Dim PDF
Set PDF = CreateObject("CDIntfEx.CDIntfEx.6.5")
' Get a reference to the installed printer.
' This will fail if the printer name passed to the DriverInit method is
' not found in the printer’s folder
PDF.DriverInit AMYUNIPRINTERNAME
' The SetDefaultPrinter function sets the system default printer to the one
' initialized by the DriverInit functions.
PDF.SetDefaultPrinter
' The EnablePrinter() method needs to be called right before each print job.
' and before the configuration
' Calling the EnablePrinter() method will start a 20 second time-out value
PDF.EnablePrinter strLicenseTo, strActivationCode
' Resulting PDF document stored here
PDF.DefaultDirectory = "C:\Temp"
' Set Printer options
PDF.FileNameOptionsEx = NoPrompt Or PrintWatermark
' Set Watermark
PDF.SetWatermarkEx "Property of Amyuni", "Arial", 36, 0, &HD4AF37, 0, -100, 4, @"c:\temp\watermark.txt"
' The BatchConvert method converts a number of files to PDF.
PDF.BatchConvert "C:\Temp\*.docx"
' The RestoreDefaultPrinter function resets the system default printer
' to the printer that was the default before the call to SetDefaultPrinter.
PDF.RestoreDefaultPrinter
' This function will simply detach from an existing printer because the handle was created using DriverInit
PDF.DriverEnd
' destroy pdf object
Set PDF = Nothing