PC SOFT

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Prints a signature in a rectangular area. This signature will be used to sign the generated PDF files or the duplicates.
Example
// Retrieve the list of certificates available on the computer
arrCertificate is array of Certificates
arrCertificate = CertificateList()
 
// Open report viewer
iDestination(iViewer)
iPrintSignature(iSignatureApproval, arrCertificate[1], "My certificate", 10, 10, 200, 200)
iEndPrinting()
Syntax

Printing a signature defined by a certificate Hide the details

<Result> = iPrintSignature(<Signature type> , <Certificate> , <Caption> , <X1> , <Y1> , <X2> , <Y2>)
<Result>: Boolean
  • True if the signature was printed,
  • False in case of failure.
<Signature type>: Integer constant
Type and format of the signature:
  • Signature type:
    iSignatureApprovalApproval signature. An approval signature corresponds to a mark applied by another person to indicate that he/she approves the document content.
    iSignatureCertificationCertification signature. A certification signature corresponds to a seal applied to the document to guarantee its integrity.
  • Versions 25 and later
    Signature format (can be combined with a signature type):
    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).
    iSignature_PKCS7
    (default value)    		PKCS7 signature format. This is an Adobe standard format not approved by the ETSI and Chorus standards.
    New in version 25
    Signature format (can be combined with a signature type):
    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).
    iSignature_PKCS7
    (default value)    		PKCS7 signature format. This is an Adobe standard format not approved by the ETSI and Chorus standards.
    Signature format (can be combined with a signature type):
    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).
    iSignature_PKCS7
    (default value)    		PKCS7 signature format. This is an Adobe standard format not approved by the ETSI and Chorus standards.
<Certificate>: Certificate variable
Name of Certificate variable containing the signature to use.
<Caption>: Character string (with quotes)
Text displayed in the signature area.
<X1>: Real
Horizontal coordinate of top left corner of signature area (in millimeters).
Value included between 0 and the page width (returned by iPageWidth).
<Y1>: Real
Vertical coordinate of the top left corner of signature area (in millimeters).
Value included between 0 and the page height (returned by iPageHeight).
<X2>: Real
Horizontal coordinate of the bottom right corner of signature area (in millimeters).
Value included between 0 and the page width (returned by iPageWidth).
<Y2>: Real
Vertical coordinate of the bottom right corner of signature area (in millimeters).
Value included between 0 and the page height (returned by iPageHeight).
Versions 22 and later

Printing a signature defined by a pdfSignature variable Hide the details

<Result> = iPrintSignature([<Signature type>, ] <Signature>)
<Result>: Boolean
  • True if the signature was printed,
  • False in case of failure.
<Signature type>: Optional Integer constant
Type and format of the signature:
  • Signature type:
    iSignatureApprovalApproval signature. An approval signature corresponds to a mark applied by another person to indicate that he/she approves the document content.
    iSignatureCertificationCertification signature. A certification signature corresponds to a seal applied to the document to guarantee its integrity.
  • Versions 25 and later
    Signature format (can be combined with a signature type):
    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).
    iSignature_PKCS7
    (default value)    		PKCS7 signature format. This is an Adobe standard format not approved by the ETSI and Chorus standards.
    New in version 25
    Signature format (can be combined with a signature type):
    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).
    iSignature_PKCS7
    (default value)    		PKCS7 signature format. This is an Adobe standard format not approved by the ETSI and Chorus standards.
    Signature format (can be combined with a signature type):
    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).
    iSignature_PKCS7
    (default value)    		PKCS7 signature format. This is an Adobe standard format not approved by the ETSI and Chorus standards.
<Signature>: pdfSignature variable
Name of pdfSignature variable containing the signature to use.
New in version 22

Printing a signature defined by a pdfSignature variable Hide the details

<Result> = iPrintSignature([<Signature type>, ] <Signature>)
<Result>: Boolean
  • True if the signature was printed,
  • False in case of failure.
<Signature type>: Optional Integer constant
Type and format of the signature:
  • Signature type:
    iSignatureApprovalApproval signature. An approval signature corresponds to a mark applied by another person to indicate that he/she approves the document content.
    iSignatureCertificationCertification signature. A certification signature corresponds to a seal applied to the document to guarantee its integrity.
  • Versions 25 and later
    Signature format (can be combined with a signature type):
    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).
    iSignature_PKCS7
    (default value)    		PKCS7 signature format. This is an Adobe standard format not approved by the ETSI and Chorus standards.
    New in version 25
    Signature format (can be combined with a signature type):
    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).
    iSignature_PKCS7
    (default value)    		PKCS7 signature format. This is an Adobe standard format not approved by the ETSI and Chorus standards.
    Signature format (can be combined with a signature type):
    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).
    iSignature_PKCS7
    (default value)    		PKCS7 signature format. This is an Adobe standard format not approved by the ETSI and Chorus standards.
<Signature>: pdfSignature variable
Name of pdfSignature variable containing the signature to use.

Printing a signature defined by a pdfSignature variable Hide the details

<Result> = iPrintSignature([<Signature type>, ] <Signature>)
<Result>: Boolean
  • True if the signature was printed,
  • False in case of failure.
<Signature type>: Optional Integer constant
Type and format of the signature:
  • Signature type:
    iSignatureApprovalApproval signature. An approval signature corresponds to a mark applied by another person to indicate that he/she approves the document content.
    iSignatureCertificationCertification signature. A certification signature corresponds to a seal applied to the document to guarantee its integrity.
  • Versions 25 and later
    Signature format (can be combined with a signature type):
    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).
    iSignature_PKCS7
    (default value)    		PKCS7 signature format. This is an Adobe standard format not approved by the ETSI and Chorus standards.
    New in version 25
    Signature format (can be combined with a signature type):
    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).
    iSignature_PKCS7
    (default value)    		PKCS7 signature format. This is an Adobe standard format not approved by the ETSI and Chorus standards.
    Signature format (can be combined with a signature type):
    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).
    iSignature_PKCS7
    (default value)    		PKCS7 signature format. This is an Adobe standard format not approved by the ETSI and Chorus standards.
<Signature>: pdfSignature variable
Name of pdfSignature variable containing the signature to use.
Remarks
  • To print an image in the signature area, use iPrintImage:
    iPrintSignature(iSignatureApproval, MySignature, "", 150, 200, 250, 250)
    iPrintImage("signature test.jpg", 150, 200, 250, 250)
  • In a report created with the report editor, use a Signature control to sign the PDF files. See The Signature control for more details.
  • Caution: In order for a signed PDF file to be recognized by Acrobat, the company issuing the signature certificate must be member of AATL list (Adobe Authorized Trust List) or member of CDS program (Certified Document Services).
    If the certificate is not recognized, Acrobat will display a banner saying "At least one signature presents a problem...".
Business / UI classification : Neutral code
Component : wd250prn.dll
See also
Minimum version required
  • Version 21
This page is also available for…
Comments
Click [Add] to post a comment