Editbox Properties

Select Editbox on the Screen Design page to view and configure its properties.

General control properties

These are general properties for most controls.

Property Description
Label This property applies to all controls except HtmlView and Listview.
  • Label – enter the text that describes the control on the user interface.
  • Label position – the position of the label in relation to the control it describes.
Input data binding
  • Key – the unique identifier within the scope of the widget, used when setting or retrieving a value.

    Click New key to create a new key for the control.

  • Default value – default value for the control.
Read only This property applies to all controls except HtmlView and Listview. Select to make the control read-only.
Note: The read-only property is not supported on the Windows Mobile platform for the Checkbox, Slider, and Choice controls.

Editbox general properties

These are the general properties that apply to the editbox control.

Property Description
Password If selected (set to true), text entered in the editbox is replaced with asterisks. The default is false.
Locale specific This option is enabled only with DATE, DATETIME, and TIME logical types. If selected, the content of the cell is rendered in Locale Display format.
Logical type Select the logical type for the editbox:
  • TEXT
  • NUMERIC
  • DATE – uses absolute values or values relative to the current day using simple calculations in days, for example, “2008-05-24” "today" "today+1" "today-1." All values are expected to be in UTC.
  • DATETIME – uses absolute values or values relative to the current time or day using simple calculations in seconds, for example, "2008-05-24" or "2008-05-24T14:30:15" "today" "today+86400" or "today-86400." In "today+nnn," the nnn means seconds and "today" is interpreted as the current date time 12:00PM.
  • TIME – uses only absolute values, for example, "14:30" or "14:30:15." Valid values are 00:00:00 to 23.59:59.
Note: The properties that you can configure depend on the logical type set for the editbox control. Some properties apply only to the numeric type, some apply only to the text type, and so on.

Advanced

These are the advanced properties that apply to the editbox.

Property Description
Content size
  • Maximum length – specify the maximum number of characters allowed for the control.
  • Number of lines – specify the number of lines for the control.
  • Number of decimals – specify the number of decimals (the number of digits after the decimal point—valid range is 0 – 28) for a number. Valid only in conjunction with numeric attributes. The default is zero.
Validation
  • Minimum value – specify the minimal value for numeric input. Valid only in conjunction with numeric attributes.
  • Maximum value – specify the maximum value for numeric input. Valid only in conjunction with numeric attributes.
  • Required – specify if user input is required. A value is required for submission.
  • Validation regular expression – if the user enters text in the control, the input has to comply to the provided regular expression.
  • Validation message – enter the error message the user sees in case the input validation criteria do not match.
Time precision Specifies the precision of the time portion displayed to the user and calculations.
Note: This property is used only if the editbox logical type is datetime or time.
Credential cache username If the widget supports cached credentials, select to specify that the editbox be treated as a user name.
Credential cache password If the widget supports cached credentials, select to specify that the editbox be treated as a password.
Parent topic: Configuring Control Properties