diff -r 43e37759235e -r 51a74ef9ed63 Symbian3/SDK/Source/GUID-875D74D3-5663-42E3-A4B9-294F82FF5486.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/SDK/Source/GUID-875D74D3-5663-42E3-A4B9-294F82FF5486.dita Wed Mar 31 11:11:55 2010 +0100 @@ -0,0 +1,70 @@ + + + + + +Confirmation +note +

Confirmation notes inform the user about a successfully completed operation. +They have a short duration and a subtle tone (they should not be used after +every kind of successful action).

+ +Confirmation note + + +
Guidelines +for using confirmation notes

Use a confirmation note when:

    +
  • The effect of the operation cannot be seen directly by some +other means. For example, Message sent.

  • +
  • There is some relevant information to be communicated by it. +For example, Last call duration.

  • +

Confirmation notes should not be used after every completed operation, +as this would easily start to annoy users. Confirmation notes should not be +used when:

    +
  • There is already another dialogue in the procedure, for example Do +you want to remove this message? Y/N.

  • +
  • A progress indication is visible during the procedure.

    +
  • +
  • The user can see the result of the operation when it is performed. +For example, when adding or removing objects in a list.

  • +
  • A setting has been changed. The new value of the setting is +visible in the setting item.

  • +
  • The operation can be considered minor or so frequent that +a note would be annoying. For example, Copy-Paste actions.

  • +
+
Using +confirmation notes in C++ applications

You can create either a basic +confirmation 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 confirmation +note with the default icon, text, sound, and duration, create an instance +of the note class CAknConfirmationNote. For implementation information, see Creating a waiting confirmation (basic) note.

To +create a global confirmation note, use the class CAknGlobalNote in the Notes 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().

+ + + +
+Information +note +Warning note + +Error note + +Permanent +note +Wait note + +Progress +note +
\ No newline at end of file