Textbox
The Textbox control in the Pane Designer inserts a box in which a text can be entered. When the control is selected in the ribbon, it is inserted below the actual pane area.
Drag the textbox to the desired place in the pane:
The following properties can be changed for the Textbox control: (these properties can be found in the Art Board to the right in the Pane Designer)
Brushes
Change the color of the text box by using the brush in the art board. Changing color can be done in two ways:
- Drag the marker in the brush area to the wished color.
- Enter a specific # color code in defined area.
Layout
You can make the following changes to the text box layout:
- Width: Can be changed in the art board or by dragging the bottom-right corner of the control to the right width.
- Height: Can be changed in the art board or by dragging the bottom-right corner of the control to the right height.
- Enabled: Determines whether the control should be enabled or disabled.
- Opacity
- Hidden: Determines whether the control is visible to the end-user.
In the Layout section, the position of the box can also be viewed. View the X and Y position by dragging the control to desired position. When positioning many controls in a pane, it is a good idea to view the X position of the controls to make sure that they are positioned straight under each other.
Use the "Snap to Grid" feature for the pane to allow more precision when positioning the controls.
Common Properties
Control Tag
The controls in the pane for which values should be sent into the generated document, need to be named with a control tag. The control tag ID, will then be matched to the tags defined in the Pane worksheet in the template. In column B and C for the matched control tag the selected value from the selection pane will be inserted in the Pane worksheet.
Tooltip
Enter a tooltip that will display when the end-user hovers over the list control in the selection pane:
Mandatory
Check the box if a value in the text box is mandatory:
Get Latest Values
Check the box if you want the control to always automatically return the latest selected value. If the control also has a default procedure connected, the auto_get_latest setting will override the default value for the particular control.
Important: Not supported in dashboard panes.
Text
Enter a default text that should be visible in the text box when it is generated:
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.
Default Value(s)
There is also an option to connect the control to a script that defines a default value for the text box. If any parameter is necessary to define, then these will be visible below the "Default value(s)" list box.
For more information, see Default Value in Pane.
Text
Below is a list of the available text options:
- Font: The default font is Verdana. To change the font select one from the list.
- Size: The default size is 11. To change it enter another size in the text box.
- Bold
- Italic
- Underline