Options

From PDF XChange PDF SDK
Revision as of 16:20, 25 April 2016 by AlexIII (Talk | contribs) (Options Table)

Jump to: navigation, search


Options Table

Name Type Value
Certificate String Specifies the certificate in the system store. Represented by hexadecimal string that contains SHA1 hash of the certificate. Not used if UseFileCertificate is TRUE or DigiSigType is 4 (Timestamp).

Default value: Empty String

FileCertificate String Specifies the path to the file certificate. Not used if UseFileCertificate is FALSE or DigiSigType is 4 (Timestamp).

Default value: Empty String

UseFileCertificate Boolean Specifies whether the file certificate specified by FileCertificate will be used for signing the document. If false, certificate from the system storage, specified by Certificate, will be used for signing the document. This field is not used if DigiSigType is 4 (Timestamp).

Default value: false

SignatureAppearance Dictionary Specifies the details of the signature appearance.
TimeStamping Dictionary Specifies the timestamping parameters.
DigiSigType Integer Specifies the type of the signature.

Possible values are:

0 (Unknown) Invalid value.
1 (Approval) Approval signature.
2 (Certification) Certification signature.
3 (UsageRights) Usage Rights signature.
4 (Timestamp) Timestamp signature.

Default value: 0 (Unknown)

FieldName String Specifies the name of the field in the document, if this field should be used for digital signature.

Default value: Empty String

PageNumber Integer If the new field should be created in the document for digital signing, this value specifies the page number where this field should be placed. Used with SignatureBox and RotationFactor. Not used if FieldName contains the name of the existing field in the document.

Default value: 1

SignatureBox Dictionary If the new field should be created in the document for digital signing, this dictionary specifies coordinates of this newly created field on the page whose number specified by PageNumber. Not used if FieldName contains the name of the existing field in the document.
RotationFactor Integer If the new field should be created in the document for digital signing, this value specifies the rotation of this field. Used with PageNumber and SignatureBox. Not used if FieldName contains the name of the existing field in the document.

Valid values are:

0 No rotation.
1 90 degrees rotation.
2 180 degrees rotation.
3 270 degrees rotation.

Default value: -1 (Invalid)

CertificatePassword String Specifies the password for the certificate specified in Certificate or FileCertificate

Default value: Empty String

AskDestinationFileName Boolean Specifies whether the user will be asked about the destination file name of the resulting signed file using UI dialog. If false, DestinationFileName will be used. If false and DestinationFileName is empty, the current file of the document will be overwritten with the signed version.

Default value: false

DestinationFileName String Specifies the destination file name of the resulting signed file. Used if AskDestinationFileName is false. If AskDestinationFileName is false and this value is empty, the current file of the document will be overwritten with the signed version.

Default value: Empty String

DocMDP Integer Specifies the permissions granted for signed document.
1 No changes to the document shall be permitted; any change to the document shall invalidate the signature.
2 Permitted changes shall be filling in forms, instantiating page templates, and signing; other changes shall invalidate the signature.
3 Permitted changes shall be the same as for 2, as well as annotation creation, deletion, and modification; other changes shall invalidate the signature.

Default value: 0

LockAfterSigning Boolean Specifies...

Default value: false

SignatureAppearance Table

Name Type Value
Certificate String Specifies...

Default value: Empty String

Reason String Specifies...

Default value: Empty String

Location String Specifies...

Default value: Empty String

ContactInfo String Specifies...

Default value: Empty String

HaveTemplate Boolean Specifies...

Default value: false

Template Dictionary Specifies...
TemplateIdx Integer Specifies...

Default value: -1

Template Table

Name Type Value
GraphicType Integer Specifies...

Possible values are:

0 (None) ...
1 (Name) ...
2 (XForm) ...

Default value: 0 (None)

GraphicName String Specifies...

Default value: Empty String

TextDirection Integer Specifies...

Possible values are:

0 (Auto) ...
1 (LeftToRight) ...
2 (RightToLeft) ...

Default value: 0 (Auto)

ShowName Boolean Specifies...

Default value: false

ShowDate Boolean Specifies...

Default value: false

ShowLocation Boolean Specifies...

Default value: false

ShowReason Boolean Specifies...

Default value: false

ShowDistinguishedName Boolean Specifies...

Default value: false

ShowLabels Boolean Specifies...

Default value: false

ShowLogo Boolean Specifies...

Default value: false

ShowSubjectName Boolean Specifies...

Default value: false

ShowEditorVersion Boolean Specifies...

Default value: false

Name String Specifies...

Default value: Empty String

TimeStamping Table

Name Type Value
Enabled Boolean Specifies...

Default value: false

PresetID String Specifies...

Default value: Empty String

Data Dictionary Specifies...

Data Table

Name Type Value
URL String Specifies...

Default value: Empty String

RequireAuth Boolean Specifies...

Default value: false

User String Specifies...

Default value: Empty String

Password String Specifies...

Default value: Empty String