Edit Box Properties

Use the Edit Box control to input text and assign values to strings, dates, decimals, integers, and so on.

Edit Box control properties
Property Description
Edit Box Text The text that appears in the edit box.
Use Variable Select to use a variable for the edit box text. Click Browse to find available variables.
Password Select if the edit box is a password field.
Show Border Select to show the edit box border on the device.
Note: If you are developing an application for the BlackBerry 9530, you must select the Show Border checkbox to ensure the screen displays properly.
Read Only Sets the text in the edit box to read-only on the device.
Empty String Means NULL When selected, if the user leaves the input field empty, a NULL value is passed to the server. This is required by some back-end systems.
Note: This option is enabled only for the STRING data type.
Data Type Select the data type from the drop-down list. Use this option on the device to give menu assistance to inputs, for example, selecting a calendar for date. The device retrieves the information and performs validation on the input, for example, INT must be a number. It is also used to map the control to the operation parameter correctly.
Logical Type Sets the logical type for the edit box. This can be used on the device to give menu assistance to input fields, for example, task, calendar, e-mail, or phone.
Validation Message Sets the validation message that will display for data type or logical type mismatches. Click Restore to return the message to the default message.
Note: Validation messages should be constructed using the proper pattern format for the MessageFormat class (MessageFormat.format()).
Style Click Search to search available styles.

Click Restore to restore the default style.

Click Edit to edit the selected edit box style.

Click Clear to clear the edit box style.

Span Choose:
  • Horizontal – enter the number of columns the edit box will occupy. The number must be greater than zero, and less than or equal to the number of columns in the container.
  • Vertical – enter the number of rows the edit box will occupy.