diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-875D74D3-5663-42E3-A4B9-294F82FF5486.dita --- a/Symbian3/SDK/Source/GUID-875D74D3-5663-42E3-A4B9-294F82FF5486.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-875D74D3-5663-42E3-A4B9-294F82FF5486.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,70 +1,82 @@ - - - - - -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 + + + + + +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 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:

    +
  • CAknNoteDialog::SetIconL()

  • +
  • CAknNoteDialog::SetTextL()

  • +
  • CAknNoteDialog::SetTone()

  • +
  • CAknNoteDialog::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:

    +
  • CAknGlobalNote::SetGraphic()

  • +
  • CAknGlobalNote::SetAnimation()

  • +
  • CAknGlobalNote::SetTone()

  • +
  • CAknGlobalNote::SetSoftkeys()

  • +

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