Progress note

Progress notes contain a progress graphic of definite duration. They are used during operations that take a long time when it is possible to estimate the duration of the operation. Whenever possible, the user should be able to stop the operation. For this, a softkey labeled, example, Cancel is provided.

Figure: Progress note

Using progress notes in applications

You can create either a basic wait note that is displayed only when your application is in the foreground or a global note that stays displayed even if the application launching the note is not in the foreground. The related APIs are the Notes API (for basic notes) and the Notifiers API (for global notes).

Progress notes are predefined notes that cannot be used just by instantiating a simple note class. These notes' lifetime is based on a background process, and client code has to provide an interface to retrieve this information.

To create a global progress note, use the class CAknGlobalProgressDialog in the Notifiers API.

For basic notes, you can change the icon or text displayed in the note, use a different kind of sound, or change the note duration using the setter methods in the class CAknNoteDialog:
  • CAknNoteDialog::SetIconL()

  • CAknNoteDialog::SetTextL()

  • CAknNoteDialog::SetTone()

  • CAknNoteDialog::SetTimeout()

You can change the graphic, animation, tone, and softkeys using the methods in the class CAknGlobalNote:
  • CAknGlobalNote::SetGraphic()

  • CAknGlobalNote::SetAnimation()

  • CAknGlobalNote::SetTone()

  • CAknGlobalNote::SetSoftkeys()

For more information about these APIs, see Symbian C++ API specifications.

Related concepts