<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

	Nokia Corporation - initial contribution.

Contributors: 

-->  <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-81E33E18-D390-4110-8D85-1FCDA9CC311E" xml:lang="en"><title>Progress

note</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody>

<section id="GUID-1752AA10-5432-4EC6-BCAB-12AF0C020AB7"><p>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. <uicontrol>Cancel</uicontrol> is provided.</p><fig id="GUID-12944F1C-48F3-4E80-804B-A585B911F0C8-GENID-1-6-1-6-1-1-5-1-18-1-1-9-1-2-1-2">

<title>Progress note</title>

<image href="GUID-3F69590C-B1FB-4E73-B3D3-FD09C894BC60_d0e61414_href.png" scale="33" placement="inline"></image>

</fig></section>

<section id="GUID-D8E36599-D305-4C3B-AB3D-4BF4CF1A70E7"> 

     <title>Using progress notes in C++ applications</title>      <p>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).</p><p>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.</p> <p>To create a global progress note,

use the class <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknGlobalProgressDialog.html" format="application/java-archive"><codeph>CAknGlobalProgressDialog</codeph></xref> in the Notifiers

API. For implementation information, see Using

global notes and Using

global notes with user interaction.</p><p>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 <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknNoteDialog.html" format="application/java-archive"><codeph>CAknNoteDialog</codeph></xref>: <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknNoteDialog.html#bfce8dc1591cae822feca43a093a11a9" format="application/java-archive"><codeph>SetIconL</codeph></xref>, <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknNoteDialog.html#ae7db1ca3d39de28ae4793b4e7cf79cb" format="application/java-archive"><codeph>SetTextL</codeph></xref>, <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknNoteDialog.html#5f887d8738ed0f061a1c9e82cf3a14a5" format="application/java-archive"><codeph>SetTone</codeph></xref>, and <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknNoteDialog.html#8778e804a7709588a4cd23134f79674c" format="application/java-archive"><codeph>SetTimeout</codeph></xref>.</p><p>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 <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknGlobalNote.html" format="application/java-archive"><codeph>CAknGlobalNote</codeph></xref>: <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknGlobalNote.html#cee323af0704e07d3f1887a4a13c1639" format="application/java-archive"><codeph>SetGraphic</codeph></xref>, <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknGlobalNote.html#d23699273b28a39c0817bc575be767ab" format="application/java-archive"><codeph>SetAnimation</codeph></xref>, <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknGlobalNote.html#a8748ee0b3342c24a11b8ed0ea9121bc" format="application/java-archive"><codeph>SetTone</codeph></xref>, and <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknGlobalNote.html#f31895e5838994b1c70300cfd3d7d127" format="application/java-archive"><codeph>SetSoftkeys</codeph></xref>.</p>     </section>

</conbody><related-links>

<link href="GUID-875D74D3-5663-42E3-A4B9-294F82FF5486.dita"><linktext>Confirmation

note</linktext></link>

<link href="GUID-E449F309-F230-46F9-B777-EF64D0E3191D.dita"><linktext>Information

note</linktext></link>

<link href="GUID-ED198434-94C0-4842-8353-B2FA319BA5C7.dita"><linktext>Warning note</linktext>

</link>

<link href="GUID-E9F203A6-D9E3-41B7-9FC4-24EDE20C4753.dita"><linktext>Error note</linktext>

</link>

<link href="GUID-11B69814-5B3E-42AE-844E-998A7A08E654.dita"><linktext>Permanent

note</linktext></link>

<link href="GUID-93EFC9E4-8779-415D-ABEB-2AC9991996DD.dita"><linktext>Wait note</linktext>

</link>

</related-links></concept>