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 |