TextBox
Component definition
This component adds a text box to a form. You can use this component only in a Windows or Web form builder component. At run-time, users type text into the text box, and the component creates a process variable of the text.
Component icon
Description of component output paths
Unknown
The component output paths are described in the following table:
Property
|
Description
|
Unknown
|
Unknown
|
Unknown
|
Unknown
|
Description of component tabs and their properties
The properties on the Functionality tab in the TextBox component are listed and described in the following table:
The properties on the Appearance tab in the TextBox component are listed and described in the following table:
The properties on the Settings tab in the TextBox component are listed and described in the following table:
Connection information
Not applicable
Component settings
Unknown
Use cases
Some examples for the TextBox component are as follows:
-
Text box for various text data
A form uses text boxes for various text data.
-
Text box with default value
A form includes text boxes with predefined values. Users see this text in the text box when they first open the form.
Text box for various text data
On a survey form, employees are asked to fill in a number of fields.
The following screen shot shows the run-time form:
In this example form, the two text boxes are empty. Two label components (Name and Comments) mark the text boxes. These labels are separate components; they are not part of the text box components.
If you double-click on the Name Text Box component, you see its editor.
The following screen shot shows the TextBox editor:
The output data variable is called SurveyName. This text-type variable is available to other components in the process after the user defines it.
Text box with default value
You can make a text box display a default text value when opened in a form. For example, in an employee survey, you want instructions to appear inside each text box instead of in a label component.
The following screen shot shows the form at run time:
The following screen shot shows the text box editor when it is set to show a default text value:
Compare the TextBox component with the MaskEdit text box component. The MaskEdit text box component lets you specify a format for user input. For example, using the MaskEdit text box component, you can force users to enter a phone number in a certain format (such as xxx-xxx-xxxx).