QMenuPopout

The QMenuPopout application demonstrates the usage of menu pop outs in UIQ.

Menu pop outs are typically used to display a menu at an arbitrary position on the screen for instance at the position of the pointer when an item on screen is tapped. The messaging "Create new message" provides a good example of this. For non touch screen UI menu pop outs are usually displayed just above the soft keys.

The QMenuPopout application contains a single view which displays a text description and below this a list containing a single item. If the list item is selected a menu popout will be displayed containing two commands. Selection of either of these commands simply displays an info message containing the command text.

The width of the menu popout can be configured in one of two ways:

Wide enough to fit the command text (this is the default).
The full client width, i.e. the entire area available for drawing by the application.

The UI configuration that is used by the phone will determine where the menu popout will appear. For Softkey UI configurations the menu popout will always appear just above the softkeys.

For Pen based UI configurations the user can select which corner of the menu popout will appear when selecting the list item. The four possible options are:

TPopupTargetPosType::EPopupTargetTopLeft
TPopupTargetPosType:: EPopupTargetTopRight
TPopupTargetPosType:: EPopupTargetBottomLeft
TPopupTargetPosType:: EPopupTargetBottomRight

Class summary

CMenuPopoutApplication is the entry point to the application.

CMenuPopoutDocument represents the document in the application.

CMenuPopoutAppUi is responsible for creating the view.

CMeuuPopoutView presents a text description and list box, and launches a menu popout in response to selection of the one and only list box item.

Usage

First, run bldmake from the projects group directory where the bld.inf file is located:

> bldmake bldfiles

This creates a batch file, called abld.bat, which you use in the next step. To build the project, you call abld build which will build the project for all default targets in both release and debug variants. To build for a particular target and variant, use abld build target-name variant, for example,

> abld build winscw udeb

builds the project for the debug variant of WINSCW only. To run it, choose the application name from the Launcher.

UI configuration

This example 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 application with varying phone styles.

Changes in this version

Version 1.1 2006-12-28

Minor documentation changes.

Version 1.0 2006-11-30

First release.

Download: QMenuPopout

You need to be a registered member of the UIQ Developer Community and logged in to be able to download this file.

124.43 Kb (Last update: 2006-11-30)

«« Back