SignDoc Class Documentation

classSignDoc

Namespace:com::datalogics::PDFL

Detailed Description

Implementation of the PDF SignDoc function. Use the SignDoc object to digitally sign a document

Constructor & Destructor Documentation

SignDoc

SignDoc()

Creates an empty SignDoc object and initializes memory for its parameters.

Member Function Documentation

DisposeChildren

voidDisposeChildren()

Returns:

void

[static initializer]

static void[static initializer]()

addDigitalSignature

voidaddDigitalSignature(Documentdocument)

Parameters

document: Document

Returns:

void

Adds a digital signature using the specified credentials. If the document has not been previously signed, signs and saves the entire document. If the document has been previously signed, signs and saves only the portions of the document that have changed. If the document has been previously signed and the path to which the file is saved is NULL or the same as the path specified by the parameter, doc, signs and copies the document, saving only the portions of the document that have changed.

createCancelProc

voidcreateCancelProc(CancelProccancelProc)

Parameters

cancelProc: CancelProc

Returns:

void

Create Cancel Callback

delete

synchronized voiddelete(Booleandisposing)

Parameters

disposing: Boolean

Returns:

synchronized void

delete

synchronized voiddelete()

Returns:

synchronized void

finalize

voidfinalize()

Returns:

void

getCredentialDataFormat

CredentialDataFmtgetCredentialDataFormat()

Returns:

- Format of user-credentials used to sign the document.

Get the value of the credential data format option.

getDigestCategory

DigestCategorygetDigestCategory()

Returns:

- Member of the enumeration DigestCategory, which option to set.

Get the value of the digest category.

getDocSignType

SignatureTypegetDocSignType()

Returns:

- Member of the enumeration CSignatureType set in a document.

Get the type of signature added to a document.

getFieldID

SignatureFieldIDgetFieldID()

Returns:

- SignatureFieldID choice currently set

Get the field identifier used to determine the form field that will contain the digital signature.

getFieldName

StringgetFieldName()

Returns:

- Fully qualified field name. May return NULL based on the SignatureFieldID attribute defined by the user.

Get the form field fully qualified name of the form field that contains the digital signature.

getOutputPath

StringgetOutputPath()

Returns:

String

Get Output Path The path to which the file is saved. A path must be specified in case a full save (PDSaveFull) is needed. In case of an incremental save (PDSaveIncremental), newPath should be set to NULL. If a full save (PDSaveFull) is performed and newPath is the same as the file's original path, the new file is saved to a file system determined temporary path. The old file is then deleted and the new file is renamed to newPath.

getSignatureBoxPageNumber

longgetSignatureBoxPageNumber()

Returns:

- The page number on which signature field's widget annotation is created. A value of zero is returned if page number was not set.

Get the page number on which the widget annotation of the signature field is created.

getSignatureBoxRectangle

RectgetSignatureBoxRectangle()

Returns:

- Dimension of the annotation rectangle of the signature field being created. A value of {0,0,0,0} is returned if annotation rectangle dimension was not set.

Get the dimension of the annotation rectangle of the signature field being created.

setCredentialDataFormat

voidsetCredentialDataFormat(CredentialDataFmtvalue)

Parameters

value: CredentialDataFmt

Encoding format of credentials used to sign a document.

Returns:

void

Set the value of the credential data format option.

setDigestCategory

voidsetDigestCategory(DigestCategoryvalue)

Parameters

value: DigestCategory

Cryptographic hash function to use for generating message digests.

Returns:

void

Set the value of the digest category.

setDocSignType

voidsetDocSignType(SignatureTypevalue)

Parameters

value: SignatureType

Member of the enumeration CSignatureType to be added to a document.

Returns:

void

Set the type of signature to be added to a document.

setFieldID

voidsetFieldID(SignatureFieldIDvalue)

Parameters

value: SignatureFieldID

Identifier to determine the form field that will contain the digital signature.

Returns:

void

Set the field identifier used to determine the form field that will contain the digital signature.

setFieldName

voidsetFieldName(Stringname)

Parameters

name: String

Fully qualified name of the form field that will contain the digital signature.

Returns:

void

Set the form field fully qualified name option.

setFieldObject

voidsetFieldObject(intaValue, intbValue)

Parameters

aValue: int

a value of the CosObject.

bValue: int

b value of the CosObject.

Returns:

void

Set the form field CosObject option.

setNonPfxPassPhrase

voidsetNonPfxPassPhrase(StringpassPhrase, longpassphraseSize, CredentialStorageFmtstorageFmt)

Parameters

passPhrase: String

Passphrase used to encrypt Non-PFX private key. Should be set to NULL if unencrypted.

passphraseSize: long

Passphrase size in bytes. Shall be set to 0 if private key is unencrypted or passphrase is stored on disk.

storageFmt: CredentialStorageFmt

Storage format for passphrase.

Returns:

void

Set the passphrase used to decrypt Non-PFX credentials.

Note: The passphrase provided must use the exact same character encoding used to encrypt the private key. The application makes no effort whatsoever to re-encode the same.

setNonPfxPrivateKey

voidsetNonPfxPrivateKey(StringprivateKey, longkeySize, CredentialStorageFmtstorageFmt)

Parameters

privateKey: String

Private key.

keySize: long

Size of private key in bytes. Shall be set to 0 if key is stored on disk.

storageFmt: CredentialStorageFmt

Storage format for private key.

Returns:

void

Set the private key for Non-PFX credentials..

setNonPfxSignerCert

voidsetNonPfxSignerCert(StringsignerCert, longcertSize, CredentialStorageFmtstorageFmt)

Parameters

signerCert: String

Signer certificate

certSize: long

Size of signer certificate in bytes. Shall be set to 0 if certificate is stored on disk.

storageFmt: CredentialStorageFmt

Storage format for the signer certificate.

Returns:

void

Set the signer certificate for Non-PFX credentials.

setOutputPath

voidsetOutputPath(StringnewPath)

Parameters

newPath: String

Returns:

void

Set Output Path The path to which the file is saved. A path must be specified in case a full save (PDSaveFull) is needed. In case of an incremental save (PDSaveIncremental), newPath should be set to NULL. If a full save (PDSaveFull) is performed and newPath is the same as the file's original path, the new file is saved to a file system determined temporary path. The old file is then deleted and the new file is renamed to newPath.

setPfxCredentials

voidsetPfxCredentials(Stringcredentials, CredentialStorageFmtstorageFmt)

Parameters

credentials: String

Credentials in PFX/PKCS#12 file format.

storageFmt: CredentialStorageFmt

Storage format for the signer certificate. (Only OnDisk is allowed for this option)

Returns:

void

Set PFX/PKCS#12 credentials.

setPfxPassPhrase

voidsetPfxPassPhrase(Stringpassphrase, longpassphraseSize, CredentialStorageFmtstorageFmt)

Parameters

passphrase: String

Passphrase used to encrypt PFX/PKCS#12 credentials. Shall be set to NULL if credentials are unencrypted.

passphraseSize: long

Passphrase size in bytes. Shall be set to 0 if PFX credentials are unencrypted or passphrase is stored on disk.

storageFmt: CredentialStorageFmt

Storage format for PFX/PKCS#12 credentials.

Returns:

void

Set the passphrase used to decrypt PFX/PKCS#12 credentials. Note: The passphrase provided must use the exact same character encoding used to encrypt the PFX credentials. The application makes no effort whatsoever to re-encode the same.

setSignatureBoxPageNumber

voidsetSignatureBoxPageNumber(longvalue)

Parameters

value: long

Page number on which to create the widget annotation.

Returns:

void

Set the page number on which the widget annotation of the signature field is created.

setSignatureBoxRectangle

voidsetSignatureBoxRectangle(Rectrect)

Parameters

rect: Rect

Dimension of the annotation rectangle of the signature field.

Returns:

void

Set the dimension of the annotation rectangle of the signature field being created.

setSignerInfo

voidsetSignerInfo(StringlogoFilePath, floatlogoOpacity, Stringname, Stringlocation, Stringreason, StringcontactInfo, DisplayTraitsdisplayTraits)

Parameters

logoFilePath: String

Image to display as part of signature appearance.

logoOpacity: float

Opacity of image to display as part of signature appearance.

name: String

Name of the person or authority signing the document.

location: String

CPU host name or physical location of the signing.

reason: String

Reason for signing the document.

contactInfo: String

Information provided by the signer to enable recipients to contact signer for signature verification.

displayTraits: DisplayTraits

Fields to display as part of signature appearance.

Returns:

void

Set Signer Info.