Progress and wait notes in Symbian C++

Comments

EEikDialogFlagNotifyEsc for CAknWaitDialog (in .rss)

Hi,

I would like to comment that EEikDialogFlagNotifyEsc is already included in EAknWaitNoteFlags. So it does not make sense to specify this twice in the .rss file. See avkon.hrh:

1. define EAknProgressNoteFlags (EAknDialogGenericNoteFlags | EEikDialogFlagNotifyEsc)
2. define EAknWaitNoteFlags (EAknProgressNoteFlags)

BR,

Rene

---

Log in or Join to leave comments.

The following code snippet shows how you could use progress and wait notes with your applications. Note that only the effected functions are shown here, thus you are expected to copy-paste the functions to your own class definition.

Article Metadata

---

Article

Created: symbianyucca (30 Mar 2007)

Last edited: hamishwillee (08 May 2013)

With this example StartWaitNoteL() can be used to start showing standard wait dialog, when the progress length can not be estimated, for the progress dialog you need to supply the final value as an argument variable when using StartProgressNoteL()-function.

To show the progress with progress dialog you could use UpdateProcessL() to supply the current progress value along side with the progress text.

The callback interface function DialogDismissedL() is called not only if user presses cancel button, but also after ProcessFinishedL() is called. Therefore you should cancel any process inside DialogDismissedL() if, and only if, aButtonId equals to the key used to close dialog, in this case EAknSoftkeyCancel.

Source code

CMyClass::~CMyClass()
{
   if(iProgressDialog)
   {
      TRAP_IGNORE(iProgressDialog->ProcessFinishedL());
   }
 
   if(iWaitDialog)
   {
      TRAP_IGNORE(iWaitDialog->ProcessFinishedL());
   }
}
 
 
void CMyClass::StartWaitNoteL()	
{
 
   iWaitDialog = new (ELeave) CAknWaitDialog(
     (REINTERPRET_CAST(CEikDialog**, &iWaitDialog)), 
     ETrue);
   iWaitDialog->PrepareLC(R_WAIT_NOTE_SOFTKEY_CANCEL);
   iWaitDialog->SetCallback(this);
   iWaitDialog->RunLD();
}
 
void CMyClass::StartProgressNoteL(TInt aFinalValue)	
{
   iProgressDialog = new (ELeave) CAknProgressDialog(
     (REINTERPRET_CAST(CEikDialog**, &iProgressDialog)),
     ETrue);
   iProgressDialog->PrepareLC(R_PROGRESS_NOTE);
   iProgressInfo = iProgressDialog->GetProgressInfoL();
   iProgressDialog->SetCallback(this);
   iProgressDialog->RunLD();
   iProgressInfo->SetFinalValue(aFinalValue);	
}
 
void CMyClass::UpdateProcessL(TInt aProgress,const TDesC& aProgressText)
{
   if(iProgressDialog)
   {
      iProgressDialog->SetTextL(aProgressText);
   }
 
   if(iProgressInfo)
   {
      iProgressInfo->SetAndDraw(aProgress);	
   }
}
 
void CMyClass::DialogDismissedL(TInt aButtonId)
{	
   iProgressDialog = NULL;
   iProgressInfo = NULL;
   iWaitDialog = NULL;
 
   if (aButtonId == EAknSoftkeyCancel)
   {
      // cancel any process in here
   }
}

Header definitions

#include <eikprogi.h>
#include <aknwaitdialog.h> 
#include <AknProgressDialog.h>
// Link against eikctl.lib
 
class  CMyClass : public CBase, public MProgressDialogCallback
{	
public: 
   ~CMyClass();
 
   void StartWaitNoteL();
   void StartProgressNoteL(TInt aFinalValue);
   void UpdateProcessL(TInt aProgress,const TDesC& aProgressText);
 
protected:// other system interface functions
   void DialogDismissedL (TInt aButtonId);
 
private:	
   CAknProgressDialog*  iProgressDialog;
   CEikProgressInfo*    iProgressInfo;
   CAknWaitDialog*      iWaitDialog;
};

Resource definitions

RESOURCE DIALOG r_wait_note_softkey_cancel
    {
    flags = EAknWaitNoteFlags | EEikDialogFlagNotifyEsc;
    buttons = R_AVKON_SOFTKEYS_CANCEL;
    items =
        {
        DLG_LINE
            {
            type = EAknCtNote;
            id = EGeneralNote;
            control= AVKON_NOTE 
                { 
                layout = EWaitLayout;
                animation = R_QGN_GRAF_WAIT_BAR_ANIM;
                };
            }
        };
    }
 
RESOURCE DIALOG r_progress_note
    {
    flags = EAknProgressNoteFlags;
    buttons = R_AVKON_SOFTKEYS_CANCEL;
    items =
        {
        DLG_LINE
            {
            type = EAknCtNote;
            id = EProgressNoteId;
            control = AVKON_NOTE
                {
                layout = EProgressLayout;
                singular_label ="Progressing";
                };
            }
        };
    }

Required Libraries

You should add the required libraries: avkon.lib, eikcdlg.lib and eikctl.lib in the .mmp file (if not already added). These libraries are required to use CEikProgressInfo API.

You are also expected to have the definitions of EYBWaitNoteId and EProgressNoteId in a hrh file included to your rss file.