ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / PDF functions
  • Properties specific to pdfSignature variables
  • Visible or invisible signature
  • Functions that use pdfSignature variables
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
pdfSignature (Type of variable)
In french: pdfSignature
The pdfSignature type is used to define the advanced characteristics of the signature that will be applied to a PDF file: The characteristics of this signature can be defined and changed using different WLanguage properties.
Remark: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
Example
MySignature is pdfSignature
MySignature.Certificate = CertificateLoad("test.pfx", "pwd")[1]
MySignature.Caption = "Signed by test"
MySignature.X = 10
MySignature.Y = 10
MySignature.Width = 150
MySignature.Height = 50
PDFSign("MyPDFFile.pdf", MySignature)
Remarks

Properties specific to pdfSignature variables

The following properties can be used to handle the signature of a PDF file:
Property nameType usedEffect
BackgroundBrushInteger constantPattern used to fill the signature border:
  • iCrossed: Crossed brush.
  • iDiagonalCrossed: Brush crossed diagonally.
  • iDownwardDiagonal: Downward diagonal brush.
  • iUpwardDiagonal: Upward diagonal brush.
  • iHorizontal: Horizontal brush.
  • iSolid (default value): Solid brush.
  • iVertical: Vertical brush.
BackgroundColorInteger constantBackground color used for the signature area. This parameter can correspond to:
Before version 24, this property was named "BackgroundColor".
BorderBorder variableDescription of signature border.
CaptionCharacter stringTexte of signature.
To make a signature invisible, this property and the Image property must not be specified. The Caption property can also be an empty string.
CertificateCertificate variableCertificate used to sign the PDF.
HeightRealHeight of signature rectangle in the page (in millimeters). This height must be greater than 0.
HorizontalAlignmentInteger constantHorizontal alignment of signature text:
  • iCenterH: Text horizontally centered.
  • iLeft (default value): Text aligned to left.
  • iRight: Text aligned to right.
ImageImage variableSignature image.
To make a signature invisible, this property and the Caption property must not be specified.
OpacityIntegerOpacity of the background color in the signature area. Value included between 0 and 100:
  • 0: Transparent background,
  • 100: Opaque background.
PageIntegerNumber of the page where the signature is displayed. This property is set to 0 by default (which means that the signature is displayed at the end of document).
VerticalAlignmentInteger constantVertical alignment of signature text:
  • iBottom: Text aligned at bottom.
  • iCenterV: Text vertically centered.
  • iTop (default value): Text aligned at top
WidthRealWidth of signature rectangle in the page (in millimeters). This width must be greater than 0.
XRealX-coordinate of the position of the signature area in the page (in millimeters)
YRealY-coordinate of the position of the signature area in the page (in millimeters)

Visible or invisible signature

If the Caption and Image properties are not specified, the signature will be invisible: the document will be signed and a blue bar will be displayed by Adobe Reader but the signature will not be visible in the document.
Otherwise, the signature will appear in the document with the parameters specified by the different properties of the pdfSignature type.

Functions that use pdfSignature variables

iPrintSignaturePrints an image of the signature in a rectangular area.
PDFSignApplies an approval signature to an existing PDF.
Minimum version required
  • Version 22
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/02/2023

Send a report | Local help