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 |