TextBox (Control)
The TextBox control is an input field with a label. You can display static or dynamic text in it.
Click TextBox on the left side of the toolbar and drag the control into the form. Once the control is placed, the properties open on the right.
Properties
Frequently used
This category displays frequently used controls, properties, and options for each control. You cannot edit the category.
General
| Enabled | This determines whether the TextBox can be edited or is only visible. The option is selected by default. If the TextBox is deactivated, it is displayed grayed out. |
| Error message |
Here you can enter a text that will be displayed when the Mandatory field option is checked. To display the note, move your mouse over the yellow triangle in the form.
|
| Content | Use the […] button to select a property. |
| Maximum Length (version 7.4 and higher) |
Use this to define the maximum character length for the text. By default, no limit is set (value = 0). Enter a value. As soon as the length is exceeded in the form, the text field is marked with a red frame and a yellow triangle. A click on the triangle shows via a tooltip how many characters may be used. The length limit can be removed with the value 0.
|
| Multiple lines | You can wrap the text within the text field with the Enter key. |
| Mandatory | Select this option if you want the text field to be a mandatory field. Mandatory fields must not be left empty and are therefore marked with a red frame and a yellow triangle. You can enter a note for mandatory fields using the Error text for the user option. |
| Read only | Select this option if you do not want to change the contents of the text field. It is possible to copy the contents from the field. |
Label
You can place labels on the left, right, above or below an image. It is also possible to specify more than one label. Labels that you want to display must be made visible. Depending on where you want to place a label, you must click on the arrow behind Bottom, Left, Right, Top to display further properties for the label.
| Alignment (horizontal) | Determines the text alignment within the control. The text can be Left, Right, or Center. |
| Alignment (vertical) | Determines the text alignment within the control. The text can be aligned up, down, or centered. |
| Label | Here you enter a label, which is displayed to you as a name in the form. The label can be created in two languages. You can also specify whether the label is displayed in bold, italic, or bold and italic. |
| Bold/ italic | Here you can format the text that you have entered under Label/ Label. |
| Visibility | Use the dropdown menu to select whether the label should be Visible, Hidden, or Collapsed. |
| Visible | The label entered is displayed. |
| Hidden | The label entered is not displayed. The space occupied by the label remains. |
| Collapsed | The entered label is not displayed. The space occupied by the label is also not displayed. |
Layout
Alignment
Here you determine how the image should take its place horizontally or vertically within the container (blue frame).
| Horizontal | |
| Left | The TextBox is aligned to the left. |
| Right | The TextBox is aligned to the right. |
| Center | The TextBox is aligned in the middle. |
| Fill | The TextBox occupies the entire available space. |
| Vertical | If you want to make settings for vertical alignment, you must set the value under Cell/ Vertical to Fill. If you select Auto, no vertical alignment will be displayed. |
| Top | The TextBox is aligned under the previous item. |
| Bottom | The TextBox is aligned at the bottom. |
| Center | The TextBox is aligned in the middle. |
| Fill | The TextBox occupies the entire available space. |
Cell
Here you determine how much space the TextBox should occupy horizontally or vertically.
| Auto | The TextBox occupies the minimum available space. |
| Fill | The TextBox occupies the maximum available space. |
Size
Calculation Using the dropdown menu, select whether the values entered – which are entered under Width and Height – refer exclusively to the control or whether the label should be included in the calculation.
Height/ Width Here you can enter values for height and width in px. If the fields remain empty, the width and height are calculated automatically. The width is calculated from the actual available space.
Display
Visible Use the check box to specify whether the TextBox should be displayed or hidden in the form. The space occupied by the TextBox remains.
Miscellaneous
Tooltip Here you can enter a tooltip that is displayed as soon as you move over the TextBox in the dialog. The tooltip can be created bilingually.