Signature

Feature Upgrade: Starting with CSPro 7.7, you should no longer use the execsystem method of capturing signatures, as it may soon be removed from CSPro. To replicate the behavior of the execsystem function call, use the image.captureSignature function.

Passing the signature command to execsystem opens the signature widget on mobile devices (i.e., Android; it will have no effect on applications run under Windows). The signature UI includes two options:

Save: Tap to save an image of the displayed signature.
Clear: Tap to to clear the displayed signature.

When using execsystem to launch the signature widget, you can include an optional text string that will appear on the mobile device's screen while the signature screen is active. The string will not be saved to the actual image file. Specify the text by following the image filename with a "|" and the overlay text, as shown in the second example below.

Examples

execsystem("signature:" + pathconcat(Application, "saved-signature.jpg"));

execsystem("signature:consent.png|Please confirm that you have read the consent statement."));