Symbian3/SDK/Source/GUID-ED198434-94C0-4842-8353-B2FA319BA5C7.dita
changeset 7 51a74ef9ed63
child 8 ae94777fff8f
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-ED198434-94C0-4842-8353-B2FA319BA5C7.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,46 @@
+<?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-ED198434-94C0-4842-8353-B2FA319BA5C7" xml:lang="en"><title>Warning
+note</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-61BDB896-12F1-43D1-B4DD-65BB42911AB6"><p>Warning
+notes are used when the user must be notified about something that may require
+action. They have a fairly long duration, and a sound that can be heard (and
+distinguished) even when not concentrating on the phone. For example, the
+battery low warning. </p></section>
+<section id="GUID-6A2B479D-A60D-4153-9221-7771F38B4A92"><title>Using
+warning notes in C++ applications</title><p>You can create either a basic
+warning 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 <xref format="html" href="specs/guides/Notes_API_Specification/Notes_API_Specification.html" scope="peer">Notes
+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 warning
+note with the default icon, text, sound, and duration, create an instance
+of the note class <xref href="GUID-D4F6D7BE-8C61-3FE7-88B0-FEBDF57BFE0D.dita"><apiname>CAknWarningNote</apiname></xref>. </p><p>To create a global
+warning note, use the class <xref href="GUID-2FF927BE-12D6-35E9-8466-011C252E5A66.dita"><apiname>CAknGlobalNote</apiname></xref> in the <xref format="html" href="specs/guides/Notifiers_API_Specification/Notifiers_API_Specification.html" scope="peer">Notifiers 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
+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="GUID-267BF374-66FD-3B7F-A56B-2A9689AEA35E.dita"><apiname>CAknNoteDialog</apiname></xref>: <codeph>SetIconL()</codeph>,<codeph>SetTextL()</codeph>, <codeph>SetTone()</codeph> and <codeph>SetTimeout()</codeph>.</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, tone, and softkeys using the methods in the class <xref href="GUID-2FF927BE-12D6-35E9-8466-011C252E5A66.dita"><apiname>CAknGlobalNote</apiname></xref>: <codeph>SetGraphic()</codeph>, <codeph>SetAnimation()</codeph>, <codeph>SetTone()</codeph>, and <codeph>SetSoftkeys()</codeph>.</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-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>
+<link href="GUID-81E33E18-D390-4110-8D85-1FCDA9CC311E.dita"><linktext>Progress
+note</linktext></link>
+</related-links></concept>
\ No newline at end of file