Description

This method returns the signature lock count of a node. If 0 is returned, the node is not signed by any digital signature, but it may have descendants that are signed.

Method

Number getSigLockCount ( );

Parameters

There are no parameters for this method.

Returns

The number of locks on the given node. On error, the custom error handler registered by the XFDL.registerAPIExceptionHandler method is called with the details of the error. If no handler is registered, the details of the error are displayed in a JavaScript alert() message.

Example

The sample code retrieves the number of signature locks on PAGE1.FIELD1 and displays the result in a JavaScript™ alert() window.

function testGetSigLockCount(theForm) {

var fieldNode;

var s;

s = "--- testGetSigLockCount results ---\n";

fieldNode = theForm.dereferenceEx(null, "PAGE1.FIELD1", 0,

FormNodeP.UFL_ITEM_REFERENCE, null);

if(fieldNode == null) {

s += "Cannot find PAGE1.FIELD1";

} else {

s += " Signature lock count for PAGE1.FIELD1: "

+ fieldNode.getSigLockCount() + "\n";

}

alert(s);

}

If PAGE1.FIELD1 is covered by one signature, then the message displayed in the alert window should be: