Form Builder Common Control Properties

These properties are common to multiple controls:

Prop-erty Description Sample Value Mand-atory or Optional Notes
Alignment Aligns the text within the control according to the alignment specified. Center Optional Options include:

Left

Center

Right

Defaults to Left.

Background Sets the background color of the control, using standard RGB format. 0, 0, 255 Optional Defaults to Gray.
Batch Approvable Displays the control on the Batch Approvals screen (if the form is Batch Approvable). A selected checkbox. Optional
Caption Literal text string that is displayed on the control. For Button: OK

For Hyperlink: WFM web site

Mandatory Defaults to "Caption"
Datafield A unique field value that is extracted from the associated Data Source control via the Datasource property. EMP_ID Mandatory when Datasource is used Must always be used in conjunction with the Datasource property.
Datasource Data Source control to which this control is mapped. dsEmployee (references the Data Source named dsEmployee, which references the Employee table) Mandatory The Datafield property value is dependent on the Datasource.

See Data Source.

Editable by Represents the individuals in the workflow who can edit the control's value. All Optional Can choose from:

All

Sender

Person1

Defaults to Sender.

Font Sets the font size and properties for the control. 12 pt., Bold, Italic Optional Defaults to 12 pt.
Foreground Represents the foreground color of the control. 0, 255, 255 Optional Defaults to Black.
Height Represents the height of the control. 20 Optional Measured in pixels.
Label This property indicates which Label control to apply to the control. See Label.
Left Specifies the distance of the control from the left margin of the workspace. 5 Optional Measured in pixels.
Name Represents the name of the control. This name is used by stored procedures when extracting the field data from a form or report. Button1 Optional Defaults to <control name> and the number, which increments based on the number of the current control being added.

For example, if this control is the fifth Button control being added to the form, the control Name would be Button5. We recommend that you change this system-generated name to a more relevant name.

On Change If selected, activates the On Change event, which occurs when the user changes a selection. This property is used for validation. For example, you can set up the property to display an alert message when a user makes a selection in a drop-down list. The following script in the On Change property of a drop-down list would present the message "You have changed your selection." when the user selects an item in the list:

alert('You have changed your selection.');

Optional
On Click If selected, activates the On Click event, which occurs when the user clicks the control. For example, the following script in the On Click property of a Button control would result in the application Web site ( www.wfm.com ) opening in a new window when the user clicks the button:

open.window('http://www.wfm.com')

Mandatory if Type property is Button.
On Focus If selected, activates the field's On focus event, which occurs when the user clicks or tabs into the field (when the field is given "focus"). This property is used for validation. For example, you can set up the property to display an alert message when a user clicks in a text field. The following script in the On Focus property of a Text control would present the message "Enter your first name." when the user clicks in the field:

alert('Enter your first name.');

Optional
On Validate If selected, activates the field's On validate event, which occurs when the user tabs out of the field or clicks on another field in the form. The following On Validate script, which runs when the user tabs out of the txtQuantity Text Box or selects another field in the form, presents the "Quantity must be greater than 0" message in an alert box:

if (txtQuantity.value == 0){ alert('Quantity must be greater than 0"); txtQuantity.focus();}

Optional
Required If selected, indicates that the data in the field control is required. If the user attempts to submit the form without completing this field, a prompt is displayed and the user cannot continue until the field is completed. A selected checkbox. Optional
Tab order Sets the tab order of the control on the form. This order is the order in which the controls are given focus if the user presses the TAB key to advance from control to control. 0, 1, 2 Optional Tab order affects the order of controls' HTML code appearance on the page. The tab order controls cursor tab order on the browsers.

Tab order cannot be used within tables because controls are ordered as they appear in the table, regardless of design-time tab order. The same applies to rectangles. Controls from one rectangle cannot have mixed tab order with controls in other rectangles.

Tooltip Represents help text that is displayed when the user moves the mouse over the control. "Click to select the appropriate option.” Optional
Top Specifies the distance of the control from the top margin of the workspace. 5 Optional Measured in pixels.
Viewable by Lists the individuals in the workflow who can view this field. All Mandatory Options include:

All

Sender

Person1

Defaults to All, Sender, and Person1.

Width Represents the width of the control. 100 Optional Measured in pixels.
Wireless label Specifies the label to use for the control when rendered on wireless devices. Addr.Emp. Name Optional