14 <p>Confirmation notes inform the user about a successfully completed operation. |
14 <p>Confirmation notes inform the user about a successfully completed operation. |
15 They have a short duration and a subtle tone (they should not be used after |
15 They have a short duration and a subtle tone (they should not be used after |
16 every kind of successful action).</p> |
16 every kind of successful action).</p> |
17 <fig id="GUID-E4323AE0-295E-42C0-8B7F-248F43CA33D6"> |
17 <fig id="GUID-E4323AE0-295E-42C0-8B7F-248F43CA33D6"> |
18 <title>Confirmation note</title> |
18 <title>Confirmation note</title> |
19 <image href="GUID-C4805C18-9BE7-47BA-9E50-D5F9CAAD36B7_d0e64639_href.png" placement="inline"/> |
19 <image href="GUID-C4805C18-9BE7-47BA-9E50-D5F9CAAD36B7_d0e59093_href.png" placement="inline"/> |
20 </fig> |
20 </fig> |
21 <section id="GUID-8204F49B-E601-4CBB-8778-33912E4EF76F"><title>Guidelines |
21 <section id="GUID-8204F49B-E601-4CBB-8778-33912E4EF76F"><title>Guidelines |
22 for using confirmation notes</title><p>Use a confirmation note when:</p><ul> |
22 for using confirmation notes</title><p>Use a confirmation note when:</p><ul> |
23 <li> <p>The effect of the operation cannot be seen directly by some |
23 <li> <p>The effect of the operation cannot be seen directly by some |
24 other means. For example, <uicontrol>Message sent</uicontrol>.</p> </li> |
24 other means. For example, <uicontrol>Message sent</uicontrol>.</p> </li> |
37 visible in the setting item.</p> </li> |
37 visible in the setting item.</p> </li> |
38 <li> <p>The operation can be considered minor or so frequent that |
38 <li> <p>The operation can be considered minor or so frequent that |
39 a note would be annoying. For example, Copy-Paste actions.</p> </li> |
39 a note would be annoying. For example, Copy-Paste actions.</p> </li> |
40 </ul></section> |
40 </ul></section> |
41 <section id="GUID-6EFD99CB-F754-4398-9526-7E51E16013A5"><title>Using |
41 <section id="GUID-6EFD99CB-F754-4398-9526-7E51E16013A5"><title>Using |
42 confirmation notes in C++ applications</title><p>You can create either a basic |
42 confirmation notes in applications</title><p>You can create either a basic |
43 confirmation note that is displayed only when your application is in the foreground |
43 confirmation note that is displayed only when your application is in the foreground |
44 or a global note that stays displayed even if the application launching the |
44 or a global note that stays displayed even if the application launching the |
45 note is not in the foreground. The related APIs are the <xref format="html" href="specs/guides/Notes_API_Specification/Notes_API_Specification.html" scope="peer">Notes |
45 note is not in the foreground. The related APIs are the <xref format="html" href="specs/guides/Notes_API_Specification/Notes_API_Specification.html" scope="peer">Notes |
46 API</xref> (for basic notes) and the <xref format="html" href="specs/guides/Notifiers_API_Specification/Notifiers_API_Specification.html" scope="peer">Notifiers API</xref> (for global notes).</p><p>To use a confirmation |
46 API</xref> (for basic notes) and the <xref format="html" href="specs/guides/Notifiers_API_Specification/Notifiers_API_Specification.html" scope="peer">Notifiers API</xref> (for global notes).</p><p>To use a confirmation |
47 note with the default icon, text, sound, and duration, create an instance |
47 note with the default icon, text, sound, and duration, create an instance |
48 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>. For implementation information, see <xref format="html" href="specs/guides/Notes_API_Specification/Notes_API_Specification.html#Notes_API_Specification.topic3.1" scope="peer">Creating a waiting confirmation (basic) note</xref>. </p><p>To |
48 of the note class <xref href="GUID-965D0CA6-7D89-3A3B-AEB5-D45FFBB29FD8.dita"><apiname>CAknConfirmationNote</apiname></xref>. For implementation |
49 create a global confirmation 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 the <xref format="html" href="specs/guides/Notes_API_Specification/Notes_API_Specification.html" scope="peer">Notes API</xref>. For implementation information, see <xref format="html" href="specs/guides/Notes_API_Specification/Notes_API_Specification.html#Notes_API_Specification.topic3.5" scope="peer">Using global notes</xref> and <xref format="html" href="specs/guides/Notes_API_Specification/Notes_API_Specification.html#Notes_API_Specification.topic3.6" scope="peer">Using global notes with user interaction</xref>.</p><p>For |
49 information, see <xref format="html" href="specs/guides/Notes_API_Specification/Notes_API_Specification.html#Notes_API_Specification.topic3.1" scope="peer">Creating a waiting confirmation (basic) note</xref>. </p><p>To |
50 basic notes, you can change the icon or text displayed in the note, use a |
50 create a global confirmation note, use the class <xref href="GUID-2FF927BE-12D6-35E9-8466-011C252E5A66.dita"><apiname>CAknGlobalNote</apiname></xref> in |
51 different kind of sound, or change the note duration using the setter methods |
51 the <xref format="html" href="specs/guides/Notes_API_Specification/Notes_API_Specification.html" scope="peer">Notes API</xref>. For implementation information, see <xref format="html" href="specs/guides/Notes_API_Specification/Notes_API_Specification.html#Notes_API_Specification.topic3.5" scope="peer">Using global notes</xref> and <xref format="html" href="specs/guides/Notes_API_Specification/Notes_API_Specification.html#Notes_API_Specification.topic3.6" scope="peer">Using global notes with user interaction</xref>.</p><p>For basic |
52 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 <xref format="html" href="specs/guides/Notifiers_API_Specification/Notifiers_API_Specification.html#Notifiers_API_Specification.topic3.4" scope="peer">Enhancing global notes</xref>. You can change the graphic, animation, |
52 notes, you can change the icon or text displayed in the note, use a different |
53 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> |
53 kind of sound, or change the note duration using the setter methods in the |
|
54 class <xref href="GUID-267BF374-66FD-3B7F-A56B-2A9689AEA35E.dita"><apiname>CAknNoteDialog</apiname></xref>:<ul> |
|
55 <li><p><xref href="GUID-267BF374-66FD-3B7F-A56B-2A9689AEA35E.dita#GUID-267BF374-66FD-3B7F-A56B-2A9689AEA35E/GUID-414C2EDC-E2D4-3B36-9436-588A6E7DB674"><apiname>CAknNoteDialog::SetIconL()</apiname></xref></p></li> |
|
56 <li><p><xref href="GUID-267BF374-66FD-3B7F-A56B-2A9689AEA35E.dita#GUID-267BF374-66FD-3B7F-A56B-2A9689AEA35E/GUID-3D9DDD5D-92CB-3CF9-A8E8-A551FDDD3398"><apiname>CAknNoteDialog::SetTextL()</apiname></xref></p></li> |
|
57 <li><p><xref href="GUID-267BF374-66FD-3B7F-A56B-2A9689AEA35E.dita#GUID-267BF374-66FD-3B7F-A56B-2A9689AEA35E/GUID-C512B481-10C3-343A-93C0-6661544815C0"><apiname>CAknNoteDialog::SetTone()</apiname></xref></p></li> |
|
58 <li><p><xref href="GUID-267BF374-66FD-3B7F-A56B-2A9689AEA35E.dita#GUID-267BF374-66FD-3B7F-A56B-2A9689AEA35E/GUID-5C457F5F-71DB-3C45-A175-0AB6EA188186"><apiname>CAknNoteDialog::SetTimeout()</apiname></xref></p></li> |
|
59 </ul> </p><p>For information on customizing global notes, see <xref format="html" href="specs/guides/Notifiers_API_Specification/Notifiers_API_Specification.html#Notifiers_API_Specification.topic3.4" scope="peer">Enhancing global notes</xref>. You can change the graphic, animation, |
|
60 tone, and softkeys using the methods in the class <xref href="GUID-2FF927BE-12D6-35E9-8466-011C252E5A66.dita"><apiname>CAknGlobalNote</apiname></xref>:<ul> |
|
61 <li><p><xref href="GUID-2FF927BE-12D6-35E9-8466-011C252E5A66.dita#GUID-2FF927BE-12D6-35E9-8466-011C252E5A66/GUID-34F19A47-92FD-33B8-9691-4249000C4466"><apiname>CAknGlobalNote::SetGraphic()</apiname></xref></p></li> |
|
62 <li><p><xref href="GUID-2FF927BE-12D6-35E9-8466-011C252E5A66.dita#GUID-2FF927BE-12D6-35E9-8466-011C252E5A66/GUID-94D9D112-D50F-30F4-BF42-6D2B0096156E"><apiname>CAknGlobalNote::SetAnimation()</apiname></xref></p></li> |
|
63 <li><p><xref href="GUID-2FF927BE-12D6-35E9-8466-011C252E5A66.dita#GUID-2FF927BE-12D6-35E9-8466-011C252E5A66/GUID-D51CD0FE-5672-30D8-9DF0-39E94489FBB6"><apiname>CAknGlobalNote::SetTone()</apiname></xref></p></li> |
|
64 <li><p><xref href="GUID-2FF927BE-12D6-35E9-8466-011C252E5A66.dita#GUID-2FF927BE-12D6-35E9-8466-011C252E5A66/GUID-5BCD9086-4432-3D69-8194-D0131A1CD1FC"><apiname>CAknGlobalNote::SetSoftkeys()</apiname></xref></p></li> |
|
65 </ul></p></section> |
54 |
66 |
55 |
67 |
56 |
68 |
57 </conbody><related-links> |
69 </conbody><related-links> |
58 <link href="GUID-E449F309-F230-46F9-B777-EF64D0E3191D.dita"><linktext>Information |
70 <link href="GUID-E449F309-F230-46F9-B777-EF64D0E3191D.dita"><linktext>Information |