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-875D74D3-5663-42E3-A4B9-294F82FF5486" xml:lang="en"><title>Confirmation

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

    11 <section id="GUID-5DD4573D-61D8-4B78-9572-4D5BEAC53E8A"><p>Confirmation notes

    12 inform the user about a successfully completed operation. They have a short

    13 duration and a subtle tone (they should not be used after every kind of successful

    14 action).</p><fig id="GUID-E4323AE0-295E-42C0-8B7F-248F43CA33D6">

    15 <title>Confirmation note</title>

    16 <image href="GUID-6AE6AEA2-7330-433B-9994-3BC2EC5ECD38_d0e60608_href.png" scale="33" placement="inline"></image>

    17 </fig></section>

    18 <section id="GUID-8204F49B-E601-4CBB-8778-33912E4EF76F"><title>Guidelines

    19 for using confirmation notes</title><p>Use a confirmation note when:</p><ul>

    20 <li>         <p>The effect of the operation cannot be seen directly by some

    21 other means. For example, <uicontrol>Message sent</uicontrol>.</p>       </li>

    22 <li>         <p>There is some relevant information to be communicated by it.

    23 For example, <uicontrol>Last call duration</uicontrol>.</p>       </li>

    24 </ul><p>Confirmation notes should not be used after every completed operation,

    25 as this would easily start to annoy users. Confirmation notes should not be

    26 used when:</p><ul>

    27 <li>         <p>There is already another dialogue in the procedure, for example <uicontrol>Do

    28 you want to remove this message? Y/N</uicontrol>.</p>       </li>

    29 <li>         <p>A progress indication is visible during the procedure.</p> 

    30      </li>

    31 <li>         <p>The user can see the result of the operation when it is performed.

    32 For example, when adding or removing objects in a list.</p>       </li>

    33 <li>         <p>A setting has been changed. The new value of the setting is

    34 visible in the setting item.</p>       </li>

    35 <li>         <p>The operation can be considered minor or so frequent that

    36 a note would be annoying. For example, Copy-Paste actions.</p>       </li>

    37 </ul></section>

    38 <section id="GUID-6EFD99CB-F754-4398-9526-7E51E16013A5"><title>Using

    39 confirmation notes in C++ applications</title><p>You can create either a basic

    40 confirmation note that is displayed only when your application is in the foreground

    41 or a global note that stays displayed even if the application launching the

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

    43 API (for basic notes) and the Notifiers

    44 API (for global notes).</p><p>To use a confirmation note with the default

    45 icon, text, sound, and duration, create an instance of the note class <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknConfirmationNote.html" format="application/java-archive"><codeph>CAknConfirmationNote</codeph></xref>.

    46 For implementation infomation, see Creating

    47 a waiting confirmation (basic) note. </p><p>To create a global confirmation

    48 note, use the class <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknGlobalNote.html" format="application/java-archive"><codeph>CAknGlobalNote</codeph></xref> in

    49 the Notifiers

    50 API. For implementation information, see Using

    51 global notes and Using

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

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

    54 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

    55 global notes, see Enhancing

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

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

    58 

    59 

    60 

    61 </conbody><related-links>

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

    63 note</linktext></link>

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

    65 </link>

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

    67 </link>

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

    69 note</linktext></link>

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

    71 </link>

    72 <link href="GUID-81E33E18-D390-4110-8D85-1FCDA9CC311E.dita"><linktext>Progress

    73 note</linktext></link>

    74 </related-links></concept>