ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

New WINDEV and WEBDEV 2024 feature!
Help / WLanguage / WLanguage functions / Standard functions / PDF functions
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
<pdfDocument variable>.Sign (Function)
In french: <Variable pdfDocument>.Signe
Applies an approval signature to an existing PDF.
Example
MyPDF is pdfDocument
MyPDF = "c:\temp\MyPDFDocument.pdf"
MySignature is pdfSignature
MyCertificates is array of Certificate = CertificateLoad("test.pfx", "pwd")
MySignature..Certificate = MyCertificates[1]
// This is an approval signature, it must have a minimum size of 1X1
MySignature.X = 1
MySignature.Y = 1
MySignature.Height = 1
MySignature.Width = 1
MyPDF.Sign(MySignature)
Syntax
<Result> = <PDF document>.Sign(<Signed PDF file> , <Signature> , <Signature mode>)
<Result>: Boolean
  • True if the PDF file was signed,
  • False otherwise.
<PDF document>: pdfDocument variable
Name of the pdfDocument variable that corresponds to the PDF document to be signed.
<Signed PDF file>: Character string
Name and path of the signed PDF file.
<Signature>: pdfSignature variable
Name of pdfSignature variable corresponding to the description of the approval signature that will be applied to the PDF file.
<Signature mode>: Integer constant
Signature format to use:
  • PAdES (PDF Advanced Electronic Signatures):
    iSignature_CAdES_BCAdES Basic (CMS Advanced Electronic Signature).
    iSignature_CAdES_CCAdES C (CMS Advanced Electronic Signature).
    iSignature_CAdES_TCAdES Trust token (CMS Advanced Electronic Signature).
    iSignature_CAdES_XCAdES X Type 2 (CMS Advanced Electronic Signature).
    iSignature_CAdES_XLCAdES XL Type 2 (CMS Advanced Electronic Signature).
  • Adobe signature format:
    iSignature_PKCS7
    (default value)
    PKCS7 signature. This is an Adobe standard format not approved by the ETSI and Chorus standards.
Remarks
  • The signature applied by <pdfDocument variable>.Sign is an approval signature. The PDF file can be signed and countersigned several times.
  • This signature must correspond to a control of PDF file (its minimum size will be set to 1 X 1 mm²). The Signature control can be invisible but we advise you to associate it with a caption or an image in order for the user to see this signature and to click it.
  • The encrypted PDF files (with password) are not supported.
  • The PDF files whose version is later than PDF 1.5 will be saved in version PDF 1.4 before they can be signed.
  • Caution: For Acrobat to recognize a signed PDF file, the organization that creates the signing certificate must be in the Adobe Approved Trust List (Adobe Authorized Trust List) or in the Certified Document Services program (CDS).
    If the certificate is not recognized, Acrobat will display the following message: "At least one signature has problems".
Business / UI classification: Neutral code
Component: wd290prn.dll
Minimum version required
  • Version 2024
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 04/09/2024

Send a report | Local help