This section describes the mobile extensions widgets.
Determining which control has focus can be difficult on mobile devices where lighting conditions are often less than optimal. (For instance, hairline width cursors in a text field can be very difficult to see even under good conditions.) This widget “captions” a control with a label that shows focus highlighting whenever the control has focus. With an entire label highlighted, it is easy to see where focus is.ContrainedText
A convenience widget which sets the initial input mode of a text field and also limits the characters than can be entered within the field. DateEditor
Allows the user to select a date, time, time offset or duration in a platform specific manner. Constructor styles allow the program to choose FULL or COMPACT display modes, or rely on the platform default. HyperLink
Displays a label in a style which indicates it can be selected. Selecting the label (containing valid link text) will cause an appropriate platform function to be launched. For instance, selecting an e-mail address link will launch the platform’s e-mail program, selecting a URL will launch the platform’s browser and selecting a phone number will cause the platform’s dialer to dial that number. Note that not all platforms may have corresponding platform function. For instance, PDAs may not have a built in phone.ListBox
This is a Model-View-Controller (MVC) style widget which displays a list of items in the most efficient/useful way for a given platform. The application may specify many hints as to how the list should be presented, but the details of the actual presentation are device dependent.ListView
This is an advanced List widget which allows inclusion of an image with each list item. The ListView layout can also be changed at runtime in order to display more or fewer items depending on the user’s preferences.MobileDevice
This object allows the application to query information about the specific device the application is running on and be informed about device state changes as they occur. For instance, an event is sent when the device is closed, or a remote keyboard becomes available.MobileShell
This widget allows applications to create a full screen window on a device, such as might be desired for a slide show or game. The window created can also dynamically change its trim to provide a window with more or less application area. MobileShell can also be used to poll for key state as commonly done within game execution loops.MultiPageDialog
This dialog allows the application to show multiple pages which are displayed one at a time. It provides function similar to TabFolder in desktop SWT, but in a more platform dependent fashion. The more restricted nature of this dialog over TabFolder allows it to map more readily to native platform functionality.QueryDialog
This dialog allows the application to query the user for a single piece of data and is provided as a convenience class.SortedList
This list widget automatically sorts its items in ascending or descending order. In addition, the end user can filter the list. That is, by entering characters, items not containing that subset of characters will not be displayed in the list. Such function is useful on devices where scrolling through a list may not be as quick or easy to do as on a desktop.TaskTip
This class provides an asynchronous indicator that a long running task is progressing. The indication is similar in purpose to a mouse-over generated ToolTip which provides a bit of extra information that is generally unobtrusive in nature. An application may open and close a TaskTip as desired.TextExtension
Basically, the Text widget with some mobile specific features. It allows a program to set the semantic meaning of the text field so that platform specific features may be utilized to aid text entry. For instance, if the field is intended to hold an e-mail address, the widget may access the system e-mail application to retrieve possible e-mail address completions that the user may select from. The initial input mode may also be set to a particular character set. The user can change the input mode as needed. Finally, the widget allows the setting of an initial casing mode, so that text can be entered in all upper case or one of several other modes. Again, the user may change the casing mode. TimedMessageBox
This dialog shows one of several styles and audible patterns. It automatically closes after a short period of time, thus reducing the need for user interaction to dismiss the dialog. For instance, such a message may be useful to inform the user than someone wants to start a chat session.
Parent topic: Using widgets on devices: XPD622