|
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 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-40F5B725-A5D7-487F-BF5D-A616F768F40D" xml:lang="en"><title>Soft |
|
13 notifications</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>Soft notifications are reminders that inform the user of events that have |
|
15 occurred in the user's absence, or while the mobile device user was busy with |
|
16 some application. Text and graphics, can be used to communicate the message |
|
17 to the user. Soft notifications are displayed in pop-up windows in the Idle |
|
18 state.</p> |
|
19 <p>The user can respond to the soft notification by using the softkeys. The |
|
20 left softkey is used for activating a function, for example opening a message |
|
21 that has arrived. The right softkey is used to discard the notification without |
|
22 taking any further action. In touch layout, the softkeys are placed inside |
|
23 the pop-up component</p> |
|
24 <fig id="GUID-604BE550-E472-4FAC-87CF-28A2928DC1E9"> |
|
25 <title>Soft notification indicating new messages</title> |
|
26 <image href="GUID-7D025BEF-61B9-4EF1-AFF7-604B500A8F2C_d0e69665_href.png" placement="inline"/> |
|
27 </fig> |
|
28 <p>Soft notifications are displayed only in the Idle state. If an event that |
|
29 causes a soft notification (for example, a missed call) occurs when an application |
|
30 is active, it may cause other kinds of UI events to notify the user, but if |
|
31 the user does not react to these, the soft notification appears only after |
|
32 the phone is put in the Idle state if the event still requires it.</p> |
|
33 <p>The application that launched a soft notification can control it and also |
|
34 discard it. It is possible to use the S60 key during a soft notification; |
|
35 in that case, the soft notification disappears, but reappears when the user |
|
36 returns to the Idle state, unless the application responsible for the notification |
|
37 has discarded it.</p> |
|
38 <p>Soft notifications can be displayed for the user in two different appearances:</p> |
|
39 <ul> |
|
40 <li><p><b>Ungrouped soft notification:</b> These notifications contain one |
|
41 piece of information each. The appearance of the notification window is the |
|
42 same as that of a note. The example in the figure below is an ungrouped soft |
|
43 notification. </p></li> |
|
44 <li><p><b>Grouped soft notification:</b> Many different items of information |
|
45 can be combined into one soft notification where the items are displayed as |
|
46 a list. The user can pick up one of the items at a time and react to it. The |
|
47 appearance of this soft notification type is the same as the appearance of |
|
48 a List query (see <xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">Queries</xref>).</p></li> |
|
49 </ul> |
|
50 <fig id="GUID-66315EEC-23D9-4484-AB66-37F2E8F43566"> |
|
51 <title>Grouped soft notification. The height of the window is dynamic and |
|
52 depends on the number of lines in the list.</title> |
|
53 <image href="GUID-81767E3E-BE4D-40D9-A4F2-3801BCCC1EA7_d0e69700_href.png" placement="inline"/> |
|
54 </fig> |
|
55 <p/> |
|
56 <table id="GUID-88A600AF-311A-486E-BE34-6D2C846C33F7"><title>Default touch |
|
57 events for ungrouped soft notification</title> |
|
58 <tgroup cols="3"><colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/><colspec colname="col3" colwidth="1.19*"/> |
|
59 <thead> |
|
60 <row> |
|
61 <entry valign="top"><p>User action</p></entry> |
|
62 <entry valign="top"><p>State change</p></entry> |
|
63 <entry valign="top"><p>Feedback</p></entry> |
|
64 </row> |
|
65 </thead> |
|
66 <tbody> |
|
67 <row> |
|
68 <entry><p>Touch down and release on <codeph>SK1</codeph> §KEY_SK1_SOFTKEY§</p></entry> |
|
69 <entry><p>Confirms the operation. </p><p>Attached application is activated, |
|
70 and displayed notification disappears completely.</p></entry> |
|
71 <entry><p>Tactile: Basic button effect and audio feedback is provided with |
|
72 touch down and basic button effect with release events.</p></entry> |
|
73 </row> |
|
74 <row> |
|
75 <entry><p>Touch down and release on <codeph>SK2</codeph> §KEY_SK2_SOFTKEY§</p></entry> |
|
76 <entry><p>Discards operation. </p><p>Attached application is discarded and |
|
77 displayed notification disappears completely</p></entry> |
|
78 <entry><p>Tactile: Basic button effect and audio feedback is provided with |
|
79 touch down and basic button effect with release events.</p></entry> |
|
80 </row> |
|
81 <row> |
|
82 <entry><p>Touch down and release on notification</p></entry> |
|
83 <entry><p>Confirms operation.</p><p>Attached application is activated, and |
|
84 displayed notification disappears completely.</p></entry> |
|
85 <entry><p>Tactile: Basic button effect and audio feedback is provided with |
|
86 touch down and basic button effect with release events.</p></entry> |
|
87 </row> |
|
88 <row> |
|
89 <entry><p>Touch down and release outside notification</p></entry> |
|
90 <entry><p>Inactive</p></entry> |
|
91 <entry><p>Tactile: No effect</p></entry> |
|
92 </row> |
|
93 </tbody> |
|
94 </tgroup> |
|
95 </table> |
|
96 <p/> |
|
97 <table id="GUID-D5917E40-42B1-461B-8722-C7AD66482078-GENID-1-8-1-6-1-1-5-1-19-1-1-2-12"><title>Default touch |
|
98 events for grouped soft notification</title> |
|
99 <tgroup cols="3"><colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/><colspec colname="col3" colwidth="1.19*"/> |
|
100 <thead> |
|
101 <row> |
|
102 <entry valign="top"><p>User action</p></entry> |
|
103 <entry valign="top"><p>State change</p></entry> |
|
104 <entry valign="top"><p>Feedback</p></entry> |
|
105 </row> |
|
106 </thead> |
|
107 <tbody> |
|
108 <row> |
|
109 <entry><p>Touch down and release on <codeph>SK2</codeph> §KEY_SK2_SOFTKEY§</p></entry> |
|
110 <entry><p>Discards the operation.</p><p>Grouped soft notification is discarded</p></entry> |
|
111 <entry><p>Tactile: Basic button effect and audio feedback is provided with |
|
112 touch down and basic button effect with release events.</p></entry> |
|
113 </row> |
|
114 <row> |
|
115 <entry><p>Touch down and release on list item</p></entry> |
|
116 <entry><p>Confirms the operation. </p><p>Attached application is activated, |
|
117 and selected choice item is removed from the soft notification list. The user |
|
118 can return to the grouped soft notification list by returning to idle state.</p></entry> |
|
119 <entry><p>Tactile: Basic button effect and audio feedback is provided with |
|
120 touch down and basic button effect with release events.</p></entry> |
|
121 </row> |
|
122 <row> |
|
123 <entry><p>Touch down and release outside notification</p></entry> |
|
124 <entry><p>Inactive</p></entry> |
|
125 <entry><p>Tactile: No effect</p></entry> |
|
126 </row> |
|
127 <row> |
|
128 <entry><p>Touch down and move on list item</p></entry> |
|
129 <entry><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
130 and flicking</xref> events</p></entry> |
|
131 <entry><p>Tactile: Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
132 and flicking</xref> events.</p></entry> |
|
133 </row> |
|
134 </tbody> |
|
135 </tgroup> |
|
136 </table> |
|
137 <section id="GUID-27C82CB3-9B88-4DD1-9B94-F5A948971B73"><title>Using |
|
138 soft notifications in C++ applications</title><p>The API to use for soft notifications |
|
139 is 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/Notifiers_API_Specification/Notifiers_API_Specification.html#Notifiers_API_Specification.topic3" scope="peer">Using the Notifiers API</xref>.</p></section> |
|
140 </conbody></concept> |