nUIEntryElement
com.softwareag.mobile.runtime.nui.nUIEntryElement
Use to display a text entry box. You can restrict the user input to alphanumeric characters or only numbers. You can mask the field's contents, making the field suitable for a user to enter passwords or personal identifier numbers (PIN)s.
Usage Notes
Set the
Format attribute to indicate the type of text allowable in the text entry field. Use one of the following values:
Value | Meaning |
nUIEntryElement.FORMAT_STRING_ANY | Alphanumeric field |
nUIEntryElement.FORMAT_NUMBER_ANY | Numeric-only field |
nUIEntryElement.FORMAT_STRING_HIDDEN | Hidden (masked) alphanumeric password field |
nUIEntryElement.FORMAT_PIN_HIDDEN | Hidden (masked) PIN field |
Use the
HintText attribute to provide text to indicate what the user should enter in the entry field. The text displays in the entry field, typically in a light gray, and disappears as soon as the user starts typing in the field.
The following lists platform considerations:
iOS | Hint text does not display in multi-line entry boxes. |
Example
This code sample displays a text box. Details on how the example code is rendered on various platforms follow the code sample.
view.add(new nUIEntryElement(NUIID_MY_ENTRY, "nUIEntryElement"));
Platform | Platform-Specific Class and Visual Reference |
Android | android.widget.EditText |
iOS | UITextField for a single-line text box UITextView for a multi-line text box |