QListBox

Found in: Examples\UIQ\QListBox

The List Box applications demonstrate the usage of the List Box in UIQ.

This project creates several List Box examples, from simple to more advanced examples that highlight different areas in the List Box. The reason for having several examples is that developers that use UIQ's SDK examples have different levels of skills and experience. You can see the examples as a tutorial in three stages, easy, medium and advanced. The medium example is an extension of the easy example and so on.

The UI configuration that is used by the phone determines the look and feel of the application. List Box examples supports the reference UI Configurations that are supported in the UIQ 3 SDK. For development purposes, UiqEnv allows to change the UI Configuration in the emulator in order to develop and test the applications with varying phone styles.

Build the List Box project in the normal way. You can either build each example individually or all at once. To run one of the examples, choose one of the List Box applications from the Launcher.

List box easy contains of a very simple List Box with plain text. It uses the standard layout EQikListBoxLine. The application only contains a list view with the List Box. New entries cannot be added to the List Box; all entries that are available are initiated when the application starts. The list loops when highlight reaches the top or bottom of the view.

CListBoxApplication is the entry point to the application.

CListBoxDocument represents the document in the commands application.

CListBoxAppUi is responsible for creating the view.

CListBoxListView presents a List Box with 10 entries.

List box medium is extended with highlight area. It uses standard layout, EQikListBoxIconLine, for normal mode, and EQikListBoxIconTwoLines for highlight mode. Entries can be added. Single deletion is available; only the item that is highlighted can be deleted.

CListBoxApplication is the entry point to the application.

CListBoxDocument represents the document in the commands application.

CListBoxAppUi is responsible for creating the view.

CListBoxListView is used to create and delete entries in List Box. Each item that is added is given the same name plus an integer value that is one greater than the most recently added entry.

List box advanced consists of two views, list view and detail view. It is possible to view the data for an entry in detail view. Adding, removing and updating entries in List Box is possible; detail view is used to create new entries. It is possible to delete multiple entries by using check marks. The List Box shares the application space with a label at the bottom that is used to write out the last event that has taken place.

The List Box example is very similar to My directory, where the user can store information about personal belongings such as media content, for example, movies, music and books. These items are presented in a way that allows the user to add, remove and edit the items. An item stores information about title, year and priority. The major difference between this example and My directory is that, in this example, the main focus is on the List Box.

The application contains two views:

• The list view presents all of the media items in a list. In the list view, media items can be added or removed and the detail view for an item can be opened. The list view contains a list box and a label that is used to present the most recent event that has taken place.

• The detail view presents details for one media item. In the detail view, the information that is stored about the item is presented and can be changed. Moreover, new media items can be created.

CListBoxApplication is the entry point to the application.

CListBoxDocument is responsible for storing all domain data.

CListBoxAppUi is responsible for creating the view.

CListBoxListView presents all entries in List Box from the model in a list. New entries can be created and existing entries can be deleted in the list view.

CListBoxDetailView is used to create new items in List Box or to show detailed information about an item. In this view, items can even be edited or deleted.

CListBoxModel is responsible for storing domain data that is used in the application. This model is used to separate application data from UI code. This makes it easier to change the UI in the future because none of the code that handles the data has to be changed.

CListBoxItem contains all data that is needed for an item in List Box.