12.1.2.1.1.8. Free Draw

A free draw control is a digital tool for creating freehand drawings.

When a free draw control is selected in the design environment, its associated properties are displayed in the Control Properties panel.

*To access the Control Behavior category, users must first create the form behavior.

1. Binding: In this category, users can link a control to its corresponding attribute.
   • Attribute: This field allows users to select the attribute associated to the control.
     • To access the list of relevant attributes, click on the ellipses () inside the field.
       

       **In the Object Browser window, users can access a list of the associated entity’s attributes—specifically, the attributes relevant to the control. To select an attribute, either click on the Select button or double-click on the entry from the list.

     • Once an attribute has been selected, it will populate the Attribute field.
       

*To create attributes for free draw controls, users must use either the VarBinary or VarBinary_Max data type.

2. Name: In this category, users can access basic properties required for the control’s identification and proper referencing in the code.
   • For more information on these properties and how to configure them, click here.
3. Control Behavior: In this category, users can configure the behavior of the control and define how it interacts with the form or application.
   • For more information on these properties and how to configure them, click here.

     !!Please note that the linked section contains information on setting an initial value, which is not applicable to free draw controls and can be ignored. In addition, regarding control governance properties, users are limited to configuring only the required field validation properties for free draw controls and cannot set up required range validations.

4. Appearance: In this category, users can customize the visual appearance of the control.
   • Height: This is a numeric updown field that allows users to set the height of the control.
     • By default, the height is set to 300. To adjust this size, users can enter numbers into the field either manually or by clicking the increment/decrement arrows.
   • Width: This is a numeric updown field that allows users to set the width of the control.
     • By default, the width is set to 400. To adjust this size, users can enter numbers into the field either manually or by clicking the increment/decrement arrows.
5. Caption Appearance: In this category, users can customize the visual appearance of the control’s caption.
   • For more information on the fields in this category, click here.

Free Draw Control Preview: Web View

• To erase or undo the drawing, click on the button.