UIQ Controls - Dialog

The dialog classes have been changed in UIQ 3.0; the previous CEikDialog class has been deprecated and is replaced by CQikSimpleDialog and CQikViewDialog.

The complexity of the dialog decides which dialog framework is best to use. The two types are simple dialog and complex dialog. A simple dialog fits on the screen without scrolling, has no tabs and contains only one input control. A complex dialog requires scrolling or uses multiple tabs. It may contain several input controls.

CQikSimpleDialog is a new framework class for simple dialogs. With CQikSimpleDialog, the layout does not need to be row based; you can use whatever layout you wish. Building blocks can be used to set the layout. This makes changing the layout of the dialogs much easier. You can have different configurations for different screen modes.

Use CQikSimpleDialog only when you are handling very simple dialogs. The dialog should not contain any tabs. The controls used in the dialogs are not captioned, unless you add your own caption. Avoid scrolling. The rule is to keep it simple when you are using CQikSimpleDialog, as the name implies.

To begin with, the CQikSimpleDialog will be skinned to look like the deprecated CEikDialog. This provides for a smooth changeover from the old dialog framework based on CEikDialog to the new dialog framework based on CQikSimpleDialog and CQikViewDialog.

Dialogs that are complex, that require scrolling or use multiple tabs, are prime candidates for CQikViewDialog.CQikViewDialog is a new framework class that extends CQikMultiPageViewBase and allows for CEikDialog-like invocation. This means that the same code can be used for both views and complex dialogs. A View-dialog looks like a view but behaves like a dialog. Actually, it is a type of view. As with CQikSimpleDialog, it is possible to have different configurations for different screen modes, integral row height and pixel-perfect display.

See the API documentation for CQikSimpleDialog and CQikViewDialog.

For more information about the new dialog framework see the Programmer's guide.