nUIEntryElement

Building Mobile Enterprise Applications : webMethods Mobile Designer Native User Interface Reference : Native User Interface (NativeUI) Objects : nUIEntryElement

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
**	Alphanumeric field
N*	Numeric-only field
H**	Hidden (masked) alphanumeric password field
HN*	Hidden (masked) PIN field

If the value of the Format attribute includes H indicating a hidden (masked) field, the value of the Lines attribute is always set to 1. The Lines attribute sets the number of text entry lines in the nUIEntryElement NativeUI object.

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.
Windows Phone	Hint text does not display in hidden (masked) alphanumeric password fields or hidden (masked) PIN fields.

Example

This code sample displays a text box. Illustrations of how the example code is rendered on various platforms follows the code sample.

view.add(new nUIEntryElement(NUIID_MY_ENTRY, "nUIEntryElement"));

Platform	Platform-Specific Class and Illustration
Android	android.widget.EditText
	Normal	With Focus
iOS 7	UITextField for a single-line text boxUITextView for a multi-line text box
	Normal	With Focus
iOS 6	UITextField for a single-line text boxUITextView for a multi-line text box
	Normal	With Focus
Windows Phone	System.Windows.Controls.TextBox
	Normal	With Focus
Windows RT Windows 8	Windows.UI.Xaml.Controls.TextBox or PasswordBox
Other	Normal	With Focus

Contact Support | Community | Feedback