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-40F5B725-A5D7-487F-BF5D-A616F768F40D" xml:lang="en"><title>Soft

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

    11 <p>Soft notifications are reminders that inform the user of events that have

    12 occurred in the user's absence, or while the mobile device user was busy with

    13 some application. Text and graphics, can be used to communicate the message

    14 to the user. Soft notifications are displayed in pop-up windows in the Idle

    15 state.</p>

    16 <p>The user can respond to the soft notification by using the softkeys. The

    17 left softkey is used for activating a function, for example opening a message

    18 that has arrived. The right softkey is used to discard the notification without

    19 taking any further action.</p>

    20 <fig id="GUID-2D75DDCF-D36A-442F-82B5-7F0B4AF03FB5">

    21 <title>Soft notification indicating new messages</title>

    22 <image href="GUID-CF4F515D-433C-4E9D-AA20-56AF6572D5BF_d0e61549_href.png" scale="33" placement="inline"></image>

    23 </fig>

    24 <p>Soft notifications are displayed only in the Idle state. If an event that

    25 causes a soft notification (for example, a missed call) occurs when an application

    26 is active, it may cause other kinds of UI events to notify the user, but if

    27 the user does not react to these, the soft notification appears only after

    28 the phone is put in the Idle state if the event still requires it.</p>

    29 <p>The application that launched a soft notification can control it and also

    30 discard it. It is possible to use the S60 key during a soft notification;

    31 in that case, the soft notification disappears, but reappears when the user

    32 returns to the Idle state, unless the application responsible for the notification

    33 has discarded it.</p>

    34 <p>Soft notifications can be displayed for the user in two different appearances:</p>

    35 <ul>

    36 <li><p><b>Ungrouped soft notification:</b> These notifications contain one

    37 piece of information each. The appearance of the notification window is the

    38 same as that of a note. The example in the figure below is an

    39 ungrouped soft notification. </p></li>

    40 <li><p><b>Grouped soft notification:</b> Many different items of information

    41 can be combined into one soft notification where the items are displayed as

    42 a list. The user can pick up one of the items at a time and react to it. The

    43 appearance of this soft notification type is the same as the appearance of

    44 a List query (see <xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">Queries</xref>).</p></li>

    45 </ul>

    46 <fig id="GUID-87927C7F-7AFE-40CB-AEDF-FD5987A7A219">

    47 <title>Grouped soft notification. The height of the window is dynamic and

    48 depends on the number of lines in the list.</title>

    49 <image href="GUID-74248E6A-0EA7-4F69-85AD-2D49B02D0212_d0e61586_href.png" scale="33" placement="inline"></image>

    50 </fig>

    51 <section><title>Using soft notifications

    52 in C++ applications</title><p>The API to use for soft notifications is the Notifiers

    53 API. For implementation information, see Using

    54 the Notifiers API.</p></section>

    55 </conbody></concept>