Error +note

Error +notes are a warning to the user. They should only be used when the user has +tried to do something that may cause a considerable problem.

+Error note + +

Guidelines +for using error notes

Use an error note when:

The user does something that may cause considerable harm +immediately or later. For example, the user gives a wrong PIN code. Repeating +this couple of times would block the SIM card.

To keep error notes effective, they should be used very sparingly. +In most ordinary error cases, an information +note should be used instead of an error note. It has a less aggressive +sound and graphics.

It should also be noted that if the information +to be given is such that the user must see and acknowledge it, a confirmation +query is a better component to use than a note. Then the user must press a +key to dismiss the information, and there is time to read and think about +the notification.

Using +error notes in C++ applications

You can create either a basic error +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 an error note with the default +icon, text, sound, and duration, create an instance of the note class CAknErrorNote.

To +create a global error note, use the class CAknGlobalNote in the Notifiers +API. For implementation information, see Using +global notes and Using +global notes with user interaction.

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: SetIconL, SetTextL, SetTone, and SetTimeout.

For information on customizing +global notes, see Enhancing +global notes. You can change the graphic, animation, tone, and softkeys +using the methods in the class CAknGlobalNote: SetGraphic, SetAnimation, SetTone, and SetSoftkeys.

+ + + +