Description

Method

Parameters

A signature node is always self-signed. To determine whether a second signature has been applied to that node, you must exclude the self-signing from this check.

To exclude the self-signing from the signature check, set this to true. To include the self-signing, set this to false.

Returns

Returns true if the node is signed, false if it is not. 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 checks PAGE1.FIELD1 and PAGE1.FIELD2 for signatures. The results are displayed in a JavaScript™ alert() window.

function testIsSigned(theForm) {

var s;

var node;

s = "--- Results of isSigned test ---\n";

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

FormNodeP.UFL_ITEM_REFERENCE, null);

if(node == null) {

s += "Could not find FIELD1 on the form.\n";

} else {

s += " FIELD1 is ";

if(node.isSigned(true) == false) s += "not ";

s += "signed.\n";

}

node = theForm.dereferenceEx(null, "PAGE1.FIELD2", 0,

FormNodeP.UFL_ITEM_REFERENCE, null);

if(node == null) {

s += "Could not find FIELD2 on the form.\n";

} else {

s += " FIELD2 is ";

if(node.isSigned(true) == false) s += "not ";

s += "signed.\n";

}

alert(s);

}

If FIELD1 is signed, but FIELD2 is not signed, then the message displayed in the alert window should be: