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

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

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

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

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

     6 <!-- Initial Contributors:

     7 	Nokia Corporation - initial contribution.

     8 Contributors: 

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

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

    11 <section id="GUID-1752AA10-5432-4EC6-BCAB-12AF0C020AB7"><p>Progress

    12 notes contain a progress graphic of definite duration. They are used during

    13 operations that take a long time when it is possible to estimate the duration

    14 of the operation. Whenever possible, the user should be able to stop the operation.

    15 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">

    16 <title>Progress note</title>

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

    18 </fig></section>

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

    20      <title>Using progress notes in C++ applications</title>      <p>You can

    21 create either a basic wait note that is displayed only when your application

    22 is in the foreground or a global note that stays displayed even if the application

    23 launching the note is not in the foreground. The related APIs are the Notes

    24 API (for basic notes) and the Notifiers

    25 API (for global notes).</p><p>Progress notes are predefined notes that

    26 cannot be used just by instantiating a simple note class. These notes' lifetime

    27 is based on a background process, and client code has to provide an interface

    28 to retrieve this information. For implementation information, see Creating a progress note.</p> <p>To create a global progress note,

    29 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

    30 API. For implementation information, see Using

    31 global notes and Using

    32 global notes with user interaction.</p><p>For basic notes, you can

    33 change the icon or text displayed in the note, use a different kind of sound,

    34 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

    35 global notes, see Enhancing

    36 global notes. You can change the graphic, animation, tone, and softkeys

    37 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>

    38 

    39 

    40 

    41 </conbody><related-links>

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

    43 note</linktext></link>

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

    45 note</linktext></link>

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

    47 </link>

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

    49 </link>

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

    51 note</linktext></link>

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

    53 </link>

    54 </related-links></concept>