#include <mw/AknWaitDialog.h>
| class CAknWaitDialog : public CAknProgressDialog |
| Public Member Functions | |
|---|---|
| CAknWaitDialog(CEikDialog **) | |
| CAknWaitDialog(CEikDialog **, TBool) | |
| IMPORT_C CEikProgressInfo * | GetProgressInfo() |
| virtual IMPORT_C void | HandlePointerEventL(const TPointerEvent &) |
| Inherited Enumerations | |
|---|---|
| CAknNoteDialog:TTimeout | |
| CAknNoteDialog:TTone | |
| CAknProgressDialog:TProgressDialogState | |
| CCoeControl:TZoomType | |
| CEikDialog:@149 | |
This class is exactly like CAknProgressDialog except it should be used when the progress of the process cannot be traced and the length of the process is unknown. If that's not the case please use CAknProgressDialog.
See also: CAknProgressDialog
Usage: iWaitDialog = new(ELeave)CAknWaitDialog( (REINTERPRET_CAST(CEikDialog**,&iWaitDialog))); iWaitDialog->SetTone( CAknNoteDialog::EConfirmationTone ); iWaitDialog->ExecuteLD(R_WAIT_NOTE);
// Process finished iWaitDialog->ProcessFinishedL(); // deletes the dialog
Callback: To get a callback when/if the dialog has been dismissed use SetCallBack API (for more info see aknprogressdialog.h) or make your dialog modal. If the dialog is used as a modal, RunDlgLD returns 0 if the dialog is dismissed and EAknSoftkeyDone if not.
Always set EEikDialogFlagNotifyEsc. (or use preset avkon dialog resource flag, i.e. EAknWaitNoteFlags).
To make a dialog modal use EEikDialogFlagWait
Note! Dialog should be dismissed only by using ProcessFinishedL() method, it should not be deleted directly (i.e. delete iWaitDialog)!!!
| IMPORT_C | CAknWaitDialog | ( | CEikDialog ** | aSelfPtr | ) |
A class constructor
| Parameter | Description |
|---|---|
| aSelfPtr | Pointer to itself. The pointer needs to be valid when the dialog is dismissed and must not be on the stack. |
| IMPORT_C | CAknWaitDialog | ( | CEikDialog ** | aSelfPtr, |
| TBool | aVisibilityDelayOff | |||
| ) | ||||
A class constructor
| Parameter | Description |
|---|---|
| aSelfPtr | Pointer to itself. The pointer needs to be valid when the dialog is dismissed and must not be on the stack. |
| aVisibilityDelayOff | If set ETrue the dialog will be visible immediality. Use only when the length of the process is ALWAYS over 1.5 seconds. |
| IMPORT_C CEikProgressInfo * | GetProgressInfo | ( | ) |
CAknWaitDialog does not support this and hence this method will PANIC. Therefore do not use it.
| IMPORT_C void | HandlePointerEventL | ( | const TPointerEvent & | aPointerEvent | ) | [virtual] |
Reimplemented from CAknProgressDialog::HandlePointerEventL(const TPointerEvent &)
From CCoeControl Handles pointer events