Textbox
The Control
The Textbox Control is amongst the most common controls used in forms. It is used to get input from the user in either a controlled way (eg. request a numeric value) or non controlled way (eg. free text).
One can specify whether they want the user to enter text freely, enter a number or even perform some validations that will restrict the information that is being typed in - even while the user types.
To accomplish this, several different configuration options are available under the "Behavior" section in the Properties tab, as such the Decimals Property, the Format Property, the Maximum Length Property, the Minimum Value Property, the Password Mode Property, the Validation Group Property, the Value Converter Property and the Value Formatter Property.
Actions
When the Textbox Control is selected in the Central pane, the Actions section on the ribbon is updated to display the following items:
Move Down This action is applicable to controls that are immediate children of Container Controls. When pressed, it moves the selected control below its current position (shifting the below control above it).
Move Up This action is applicable to controls that are immediate children of Container Controls. When pressed, it moves the selected control above its current position (shifting the above control below it).
Convert To Changes the type of the selected control to another one maintaining all properties that are common to both Control Types (style, font, value, etc). Depending on the selected control type, different options are available. For example, the table container c
Events
Occurs before the Value of a control changes. You can cancel the change by setting args.Cancel to true.
Args:
Properties
Appearance
Gets or sets a color that describes the background of a control
The float CSS property places an element on the left or right side of its container, allowing text and inline elements to wrap around it.
Changes the font weight of the control, to either regular when not selected or bold when selected.
This font-style property allows you to make text appear italicized (i.e. sloped, or slanted)
Changes the font size of the control.
Sets the foreground color of the control.
When checked, instead of displaying the default single line input text box, a multiline text box appears, whose height adjusts based on its contents.
Here you can specify what text should be displayed when no value has been selected in the input field.
The text-align property specifies the horizontal alignment of the text displayed
Sets what will be displayed in a tooltip when the user hovers over the control.
Behavior
Gets or sets if the ValueChange event triggers the ValueChange event of the parent form.
If this field is used, it forces the field to accept numeric values only. Here you can specify the number of decimals you would like the value input to have.
Gets or sets the maximum value of the control.
Gets or sets the minimum value of the control.
Specifies whether this control should be disabled when form is offline.
Specifies whether this control should be hidden when form is offline.
Specifies whether this control is required when form is offline.
If password mode is selected, the field will display asterisks while the user types into the control.
Sets the item visible or not during initialization
Data Binding
This is a free text field, where one can enter comments or other notes. Comments are only visible in the designer.
Gets or sets the code that returns the default value for this control.
The name which will hold the control's stored value
Allows you to change the value returned by the control (when GetValue() is called).
Allows you to change the value set to the actual control (when SetValue(value) is called).
Layout
Sets the margin applied to the control, that is, the spacing between the control and the cell borders.
Sets the maximum height.
Sets the maximum width.
Sets the minimum height.
Sets the minimum width.
Sets the padding of the control
Miscellaneous
Specify the conditions under which the control will be enabled/disabled.
Specify the conditions under which the control will be visible/hidden