| class CAknWaitDialog : public CAknProgressDialog |
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.
CAknProgressDialogUsage: 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)!!!
| Public Member Functions | |
|---|---|
| CAknWaitDialog(CEikDialog **) | |
| CAknWaitDialog(CEikDialog **, TBool) | |
| IMPORT_C CEikProgressInfo * | GetProgressInfo() |
| IMPORT_C void | HandlePointerEventL(const TPointerEvent &) |
| Private Member Functions | |
|---|---|
| IMPORT_C void | CAknNoteDialog_Reserved() |
| IMPORT_C void | CEikDialog_Reserved_1() |
| IMPORT_C void | CEikDialog_Reserved_2() |
| IMPORT_C void * | ExtensionInterface(TUid) |
| Inherited Enumerations | |
|---|---|
| CAknNoteDialog:TTimeout | |
| CAknNoteDialog:TTone | |
| CAknProgressDialog:TProgressDialogState | |
| CCoeControl:TZoomType | |
| CEikDialog:@183 | |
| Private Attributes | |
|---|---|
| TInt | iSpare |
| IMPORT_C | CAknWaitDialog | ( | CEikDialog ** | aSelfPtr | ) |
A class constructor
| CEikDialog ** 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
| CEikDialog ** aSelfPtr | Pointer to itself. The pointer needs to be valid when the dialog is dismissed and must not be on the stack. |
| TBool 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 void * | ExtensionInterface | ( | TUid | aInterface | ) | [private, virtual] |
From CAknControl
| TUid aInterface |
| 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] |
From CCoeControl Handles pointer events
| const TPointerEvent & aPointerEvent |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.