Skip to main content

SigCtlXHTML

SigCtlXHTML

Summary

Method
(as SigCtl)
CheckHostDocument
CheckHostDocument2
GetProperty
InsertMarkup
SetProperty
Property
(as SigCtl)
Printer
Event
(as SigCtl)

Extends SigCtl, the additions are indicated below.

Methods

CheckHostDocument

Recalculates the document hash to determine whether any changes have been made since signing. The methods call SigObj.CheckSignedData with the necessary Hash data.

SignedData CheckHostDocument()
Parameters
None
Return Value
SignedData

CheckHostDocument2

Recalculates the document hash and compares it with a value stored within the HTML document itself, e.g.:

<!-- DocHash:081726885B7A342A74 -->
The hash is inserted by a Wacom HTML converter component and is used to check that documents are not changed prior to signing.

SignedData CheckHostDocument2()
Parameters
None
Return Value
SignedData

InsertMarkup

Inserts text into an HTML element. Only plain text will be allowed. It will be assigned to the innerText property of the element. The HTML element must be empty (contain no text or child elements) and the control must not contain a captured signature.

Application Notes

If a signature with associated markup is re-captured, markup will be removed from the document and lost. In order to re-capture with markup, first clear the signature and re-insert markup.

Attempting to insert markup into an element that does not exist or is not empty, or calling the method on a control that contains a signature will result in an exception being thrown in JavaScript.

Void InsertMarkup(Id, Text)
Parameters
IdString specifying the id of an HTML element in which to insert text.
TextText to insert.
Return Value
None

Properties

PropertyProperty TypeSigCtlXHTML Property Description
See SigCtl Properties
PrinterPrintObjCreates and returns a PrintObj object. Deprecated.
(Read-only)

Properties supported by GetProperty/SetProperty

NameGet/Set TypeDescription
As SigCtl supported properties with the modification:
Document_HashTypeHashTypeThe HashType used for hash creation prior to signature capture.
Only supported in SigCtlXHTML
DisablePropertyChangeNot supported in SigCtlXHTML
PostCaptureNot supported in SigCtlXHTML

Events

As SigCtl