Home · All Classes · Annotated · Functions

Customizing the Qtopia Launcher

Replacing the Qtopia Launcher

In some cases it is desirable to have a customized launcher interface better suited to the application on the target device. Qtopia supports custom launcher user interfaces via the ServerInterface. This interface provides the infrastructure necessary to implement a launcher while maintaining compatibility with the Qtopia application and document models.

The launcher user interface is part of the Qtopia server - $QPEDIR/src/server which provides services such as syncing and file-system management.

The default Qtopia launcher is implemented by the Launcher class. The first step when writing a user interface is to implement a class derived from ServerInterface. This interface provides the functionality to display the applications and documents available on a Qtopia device.

The createGUI() and destroyGUI() functions must be implemented to create and show the launcher and any other user interface components.

The functions provided by the ServerInterface manage the addition and removal of applications and documents as necessary. The ServerInterface documentation describes the functions in detail.

Reusable User-Interface Components

In addition to the launcher it is necessary to provide some system components, such as input methods and status display.

There are several classes in the default Qtopia user interface that may be re-used in a custom interface. Most user interfaces make use of some of these classes to ensure a usable system:

An interface providing these components will support the Qtopia launcher default functionality.

The Qtopia libraries also assume that QPE/Taskbar QCOP channel is available and supports the following functions:

FunctionDescription
message(QString)display a status message.
reloadApplets()release and reload the applets.

The default Qtopia launcher uses the TaskBar class to encapsulate the above functionality.

The Qtopia libraries also assume that QPE/InputMethod QCOP channel is available and supports the messages in InputMethodService.


Copyright © 2006 Trolltech Trademarks
Qtopia 4.1.7