Symbian3/SDK/Source/GUID-40F5B725-A5D7-487F-BF5D-A616F768F40D.dita
changeset 0 89d6a7a84779
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-40F5B725-A5D7-487F-BF5D-A616F768F40D.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,55 @@
+<?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-40F5B725-A5D7-487F-BF5D-A616F768F40D" xml:lang="en"><title>Soft
+notifications</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody>
+<p>Soft notifications are reminders that inform the user of events that have
+occurred in the user's absence, or while the mobile device user was busy with
+some application. Text and graphics, can be used to communicate the message
+to the user. Soft notifications are displayed in pop-up windows in the Idle
+state.</p>
+<p>The user can respond to the soft notification by using the softkeys. The
+left softkey is used for activating a function, for example opening a message
+that has arrived. The right softkey is used to discard the notification without
+taking any further action.</p>
+<fig id="GUID-2D75DDCF-D36A-442F-82B5-7F0B4AF03FB5">
+<title>Soft notification indicating new messages</title>
+<image href="GUID-CF4F515D-433C-4E9D-AA20-56AF6572D5BF_d0e61549_href.png" scale="33" placement="inline"></image>
+</fig>
+<p>Soft notifications are displayed only in the Idle state. If an event that
+causes a soft notification (for example, a missed call) occurs when an application
+is active, it may cause other kinds of UI events to notify the user, but if
+the user does not react to these, the soft notification appears only after
+the phone is put in the Idle state if the event still requires it.</p>
+<p>The application that launched a soft notification can control it and also
+discard it. It is possible to use the S60 key during a soft notification;
+in that case, the soft notification disappears, but reappears when the user
+returns to the Idle state, unless the application responsible for the notification
+has discarded it.</p>
+<p>Soft notifications can be displayed for the user in two different appearances:</p>
+<ul>
+<li><p><b>Ungrouped soft notification:</b> These notifications contain one
+piece of information each. The appearance of the notification window is the
+same as that of a note. The example in the figure below is an
+ungrouped soft notification. </p></li>
+<li><p><b>Grouped soft notification:</b> Many different items of information
+can be combined into one soft notification where the items are displayed as
+a list. The user can pick up one of the items at a time and react to it. The
+appearance of this soft notification type is the same as the appearance of
+a List query (see <xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">Queries</xref>).</p></li>
+</ul>
+<fig id="GUID-87927C7F-7AFE-40CB-AEDF-FD5987A7A219">
+<title>Grouped soft notification. The height of the window is dynamic and
+depends on the number of lines in the list.</title>
+<image href="GUID-74248E6A-0EA7-4F69-85AD-2D49B02D0212_d0e61586_href.png" scale="33" placement="inline"></image>
+</fig>
+<section><title>Using soft notifications
+in C++ applications</title><p>The API to use for soft notifications is the Notifiers
+API. For implementation information, see Using
+the Notifiers API.</p></section>
+</conbody></concept>
\ No newline at end of file