diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-81E33E18-D390-4110-8D85-1FCDA9CC311E.dita --- a/Symbian3/SDK/Source/GUID-81E33E18-D390-4110-8D85-1FCDA9CC311E.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-81E33E18-D390-4110-8D85-1FCDA9CC311E.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,52 +1,62 @@ - - - - - -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 e.g. Cancel is -provided.

- -Progress note - - -
Using -progress notes in C++ 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. For implementation -information, see Creating a progress note.

To create -a global progress note, use the class CAknGlobalProgressDialog 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().

- - -Confirmation -note -Information -note -Warning note - -Error note - -Permanent -note -Wait note - + + + + + +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.

+ +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. For implementation +information, see Creating a progress note.

To create a global progress +note, use the class CAknGlobalProgressDialog 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:

    +

  • 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()

    • +

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