Textbox
The Textbox control in the Pane Designer inserts a box in which a text can be entered.
Drag the textbox to the desired place in the pane, as demonstrated below:
The following properties can be changed for the Textbox control:
Common Properties
After adding the textbox to the plane, configure the settings in the Common Properties right panel, shown below:
The following settings are available for a selection pane textbox:
| Setting | Description | Example |
|---|---|---|
Control Tag |
Identifies the control and reads it's value when used in a form or report. |
CF_GETPANELVALUE("VERSION") |
Label Text |
Describes what the control is used for. |
|
Tooltip |
Provides extra information to the user by moving their mouse over the control. |
A $-variable can be used to display dynamic system information. Enter a $ sign to view available variables. For more information, see Pane $ Variables. |
Get Latest Value |
When enabled, populates the control with the latest selected value from user (ON/OFF). |
|
Enabled |
Determines if the control should be enabled or disabled (ON/OFF). Control can also be enabled/disabled depending on the state of another checkbox control. |
|
Hidden |
When enabled, control will not be visible for users (ON/OFF). |
|
| Mandatory | When enabled, user must select a value before the selection pane open button is unlocked (ON/OFF). | |
Validation |
On valid input, displays a validation message until user complies with validation rule. |
Use a regular expression. |
Message |
Displays a message that will be shown if input differs from validation rule. |
|
| Text |
Press $ to view existing $variables to use in the text field, or enter a fixed text. Note: This box displays a fixed text. Therefore, it is not recommended to enter a help text in the Text field, since it will then be sent in to the pane worksheet in the template (presupposed that the user forgets to enter a valid value in the text box). Instead, add help text by using a label and placing it to the right in the text box. |
A $-variable can be used to display dynamic system information. Enter a $ sign to view available variables. For more information, see Pane $ Variables. |
Data Bindings
To add a dataview for your textbox, select the Data Bindings heading in the right panel:
Select the Data Bindings heading in the right panel to add a dataview for your textbox:
Then, select the Default Value(s) drop-down and choose a data view, as demonstrated below:
As you'll notice, the Parameters section automatically populates based on the Default Value(s) you choose.
Select the data find icon to preview the selected data view, as shown below:
The Data View Preview dialog displays, like below:
In the Parameters section, select the link icon next to a parameter to link and retrieve the value from another control in the selection pane, where applicable.