Query dialog

Figure: Figure 8: Text query

Figure: Data query

Figure: Confirmation query

A query is a simplified dialog containing one or two editors. Queries provide a convenient way of getting data from the user. They typically have an OK and a Cancel button.

Query dialogs provide ready-to-use controls to query commonly used data types like text, number, date, and time. In addition, confirmation dialogs can be constructed for simple yes/no or OK/cancel queries. Single-selection and multiselection list query dialogs are also available for use. The following parts are available for modification from the CAknQueryDialog class:

• Data query

  • Header text

  • Header image/animation

  • Prompt text

  • Edit indicator (can be removed)

• Confirmation query

  • Prompt text

  • Image/animation

• List query

  • Header text

  • Header image/animation

  • List type (Single, SingleHeading, SingleGraphic, SingleGraphicHeading)

Note that in order to have a header pane, the AVKON_HEADING component should be specified as the first dialog line in the resource description. For more information on managing resource files for dialog resources, see Query dialog resource statements.

At runtime, the dialog's header pane (CAknPopupHeadingPane) can be obtained by calling the method CAknQueryDialog::QueryHeading().

For more information, see Using Dialogs API.