Warning note

Warning notes are used when the user must be notified about something that may require action. They have a fairly long duration, and a sound that can be heard (and distinguished) even when not concentrating on the phone. For example, the battery low warning.

Using warning notes in applications

You can create either a basic warning 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).

To use a warning note with the default icon, text, sound, and duration, create an instance of the note class CAknWarningNote.

To create a global warning note, use the class CAknGlobalNote 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