Editor - SignatureInk

Description

Predefined editor for capturing signatures as Ink data

The signature ink editor
Signature Ink Editor

Video: Capturing Signatures using the SignatureInk Editor

A common requirement when using the FormView control is capturing a signature. Alpha Anywhere has a Signature control, but this control captures signatures as bitmaps and is not ideal for use in a FormView control. The Ink control is better suited for this use case.

In this video we show how a FormView control is configured to use the built-in SignatureInk editor.

Download the component shown in the video.

Create A FormView with an Editor-Signature Ink Control.

  1. In the UX Builder on the UX Controls page open the 'Data Controls' menu. Click on the [List] option to add a list control to the component.

    images/esig2.png
  2. Highlight the list control in the controls tree. In the properties list on the right click on the 'List properties' property in the 'List Properties' section. The List Builder should open.

    images/esig3.png
  3. On the List Builder's 'Data Source' pane set the 'Data Source Type' to be 'Static'.

    images/esig4.png
  4. Click the [...] button next to the 'Static data' property in the 'Static Data' section of the Data Source pane.

    images/esig5.png
  5. In the 'Static Choices' dialog click on the 'Sample data' button.

    images/esig6.png
  6. Click on the 'Name and addresses' option to add this data set to the Sample Data dialog. Select the 'CR-LF format' radio button and click OK.

    images/esig7.png
  7. In the title row of the data add a pipe '|' character and a fifth field named 'Signature' and click OK. The title row should look like this:

    Firstname|Lastname|City|State|Signature
    images/esig8.png
  8. Open the 'List Layout' pane. Highlight the five static data fields and use the blue > arrow to move them from the 'Available Fields' list to the 'Columns in List' section.

    images/esig9.png
  9. Open the 'Fields' pane. Highlight the 'Signature' field. In the properties list on the right set the 'Control type' property in the 'Client-side' section to be 'Ink'.

    images/esig10.png
  10. In the 'Ink Control Properties' section set the 'Ink width' property to 100. Click OK to close the List Builder.

    images/esig11.png
  11. Highlight the list control. Open the Other Controls menu. Select the [Form View] option to add a form view control to the component.

    images/esig12.png
  12. Highlight the form view control in the control tree. Open the 'Containers' menu and click on the [Container] option.

    images/esig13.png
  13. From the 'Container Type' list select the 'EditorSet' option. Click 'Insert After'.

    images/esig14.png
  14. Highlight the EditorSet in the control tree. Open the 'Defined Controls' menu and select the Editor-SignatureInk option. Leave the editor's default name EDITOR_1 and click OK.

    images/esig15.png
  15. Highlight the Form View control. In the properties list on the right click on the [...] button next to the 'Form properties' property. The Form View Builder will open.

    images/esig16.png
  16. On the 'Data Source' pane set the 'Datasource type' property to 'List'

    images/esig17.png
  17. Set the 'List name' property to be 'list1'.

    images/esig18.png
  18. Open the 'Form Layout' pane. Click the 'Add item' button.

    images/esig19.png
  19. In the 'Select Control Type' dialog select 'Data Controls' in the Category section. In the Control section choose [Label]. Highlight the 'Firstname', 'Lastname', 'City', and 'State' fields and click OK.

    images/esig20.png
  20. Click the 'Add item' button again.

    images/esig21.png
  21. In the 'Category' list select 'Data Controls'. From the 'Control' list select [Ink-DataBound]. In the fields on the right highlight the 'Signature' field and click OK.

    images/esig22.png
  22. Highlight the [Ink-DataBound: Signature] item in the items list.

    images/esig23.png
  23. In the 'Ink Properties' section of the item properties list set the 'Ink width' to 100.

    images/esig24.png
  24. Click the 'Add item' button a third time.

    images/esig25.png
  25. In the 'Category' list select the 'Pre-defined Controls' option. In the 'Control' list select the [Save Form Edits/Cancel Edits Button] option.

    images/esig26.png
  26. Open the 'Fields' pane and highlight the 'Signature' field.

    images/esig27.png
  27. In the Field Properties section of the properties list set the 'Field type' to be 'Ink'.

    images/esig28.png
  28. Click the [...] button next to the 'Editor set' property in the 'Editing' section.

    images/esig29.png
  29. In the Editor Set menu highligh 'EDITORSET_1'. In the Editor list highlight 'EDITOR_1' and click OK.

    images/esig30.png
  30. Click OK to close the Form View Builder. Run the component in Live Preview.

    images/esig31.png
  31. Click on one of the rows in the list control. The Form View should open.

    images/esig32.png
  32. Click on the Signature item in the Form View. The Editor-SignatureInk control should open.

    images/esig33.png
  33. Create a signature in the editor. Click 'Accept' to add the signature to the Form View and the 'Save' button to add the Form View data to the list.

    images/esig34.png

See Also