nUISearchEntry

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

nUISearchEntry

com.softwareag.mobile.runtime.nui.nUISearchEntry

Use to display a search entry field. You can restrict the user input to alphanumeric characters or only numbers.

Note:

The nUISearchEntry NativeUI object is similar to the nUIEntryElement NativeUI object except that the nUISearchEntry object does not allow masking the entry field.

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

The entered text is always visible in the search entry field. If you need to mask the field's contents, for example to use for a field where a user enters passwords or personal identifier numbers (PIN)s, use nUIEntryElement object instead.

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 are platform-specific considerations:

Android	Android devices generate an EVT_TRIGGER event when a user selects the button adjacent to the text field.
iOS	iOS devices generate an EVT_TRIGGER event when a user presses the Search or Enter key. Hint text does not display in multi-line entry boxes.
Windows Phone	Windows Phone devices generate an EVT_TRIGGER event when a user selects the button adjacent to the text field or when a user presses a Search or Enter key.
Windows RT Windows 8	Windows RT/Windows 8 devices generate an EVT_TRIGGER event when a user selects the button adjacent to the text field or when a user presses the Enter key.
Other	Devices generate an EVT_TRIGGER event when a user presses the Search or Enter key.

Example

This code sample displays a search entry field. Illustrations of how the example code is rendered on various platforms follows the code sample.

view.add(new nUISearchEntry(NUIID_MY_SEARCH_ENTRY, "nUISearchEntry"));

Platform	Platform-Specific Class and Illustration
Android (API < 14)	Custom object based around android.widget.EditText with an android.widget.ImageButton
	Normal	With Focus
Android (API >= 14)	android.widget.SearchView
	Normal	With Focus
iOS 7	UISearchBar
	Normal	With Focus
iOS 6	UISearchBar
	Normal	With Focus
Windows Phone	TextBox with the Button
	Normal	With Focus
Windows RT Windows 8	Custom element based on Windows.UI.Xaml.Controls.Button and TextBox
Other	Normal	With Focus

Contact Support | Community | Feedback