Symbian3/SDK/Source/GUID-40F5B725-A5D7-487F-BF5D-A616F768F40D.dita
changeset 8 ae94777fff8f
parent 7 51a74ef9ed63
child 13 48780e181b38
equal deleted inserted replaced
7:51a74ef9ed63 8:ae94777fff8f
     7     Nokia Corporation - initial contribution.
     7     Nokia Corporation - initial contribution.
     8 Contributors: 
     8 Contributors: 
     9 -->
     9 -->
    10 <!DOCTYPE concept
    10 <!DOCTYPE concept
    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
    12 <concept id="GUID-40F5B725-A5D7-487F-BF5D-A616F768F40D" xml:lang="en"><title>Soft
    12 <concept id="GUID-40F5B725-A5D7-487F-BF5D-A616F768F40D" xml:lang="en"><title>Soft notifications</title><prolog><metadata><keywords/></metadata></prolog><conbody>
    13 notifications</title><prolog><metadata><keywords/></metadata></prolog><conbody>
       
    14 <p>Soft notifications are reminders that inform the user of events that have
    13 <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
    14 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
    15 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
    16 to the user. Soft notifications are displayed in pop-up windows in the home
    18 state.</p>
    17 screen.</p>
    19 <p>The user can respond to the soft notification by using the softkeys. The
    18 <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
    19 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
    20 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
    21 taking any further action. In touch layout, the softkeys are placed inside
    23 the pop-up component</p>
    22 the pop-up component</p>
    24 <fig id="GUID-604BE550-E472-4FAC-87CF-28A2928DC1E9">
    23 <p>Soft notifications are displayed only in the home screen. If an event that
    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
    24 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
    25 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
    26 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>
    27 the phone is put in the home screen if the event still requires it.</p>
    33 <p>The application that launched a soft notification can control it and also
    28 <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;
    29 discard it. It is possible to use the Menu key during a soft notification;
    35 in that case, the soft notification disappears, but reappears when the user
    30 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
    31 returns to the home screen, unless the application responsible for the notification
    37 has discarded it.</p>
    32 has discarded it.</p>
    38 <p>Soft notifications can be displayed for the user in two different appearances:</p>
    33 <p>Soft notifications can be displayed for the user in two different appearances:</p>
    39 <ul>
    34 <ul>
    40 <li><p><b>Ungrouped soft notification:</b> These notifications contain one
    35 <li><p><b>Ungrouped soft notification:</b> These notifications contain one
    41 piece of information each. The appearance of the notification window is the
    36 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
    37 same as that of a note. The example in the figure below is an ungrouped soft
    43 notification. </p></li>
    38 notification. </p><fig id="GUID-604BE550-E472-4FAC-87CF-28A2928DC1E9">
       
    39 <title>Soft notification indicating a new message</title>
       
    40 <image href="GUID-7D025BEF-61B9-4EF1-AFF7-604B500A8F2C_d0e64446_href.png" placement="inline"/>
       
    41 </fig></li>
    44 <li><p><b>Grouped soft notification:</b> Many different items of information
    42 <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
    43 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
    44 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
    45 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>
    46 a List query (see <xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">Queries</xref>).</p><fig id="GUID-66315EEC-23D9-4484-AB66-37F2E8F43566">
    49 </ul>
       
    50 <fig id="GUID-66315EEC-23D9-4484-AB66-37F2E8F43566">
       
    51 <title>Grouped soft notification. The height of the window is dynamic and
    47 <title>Grouped soft notification. The height of the window is dynamic and
    52 depends on the number of lines in the list.</title>
    48 depends on the number of lines in the list.</title>
    53 <image href="GUID-81767E3E-BE4D-40D9-A4F2-3801BCCC1EA7_d0e69700_href.png" placement="inline"/>
    49 <image href="GUID-81767E3E-BE4D-40D9-A4F2-3801BCCC1EA7_d0e64462_href.png" placement="inline"/>
    54 </fig>
    50 </fig></li>
       
    51 </ul>
    55 <p/>
    52 <p/>
    56 <table id="GUID-88A600AF-311A-486E-BE34-6D2C846C33F7"><title>Default touch
    53 <table id="GUID-88A600AF-311A-486E-BE34-6D2C846C33F7"><title>Default touch
    57 events for ungrouped soft notification</title>
    54 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*"/>
    55 <tgroup cols="3"><colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/><colspec colname="col3" colwidth="1.19*"/>
    59 <thead>
    56 <thead>
    63 <entry valign="top"><p>Feedback</p></entry>
    60 <entry valign="top"><p>Feedback</p></entry>
    64 </row>
    61 </row>
    65 </thead>
    62 </thead>
    66 <tbody>
    63 <tbody>
    67 <row>
    64 <row>
    68 <entry><p>Touch down and release on <codeph>SK1</codeph> §KEY_SK1_SOFTKEY§</p></entry>
    65 <entry><p>Touch down and release on left softkey.</p></entry>
    69 <entry><p>Confirms the operation. </p><p>Attached application is activated,
    66 <entry><p>Confirms the operation. </p><p>Attached application is activated,
    70 and displayed notification disappears completely.</p></entry>
    67 and displayed notification disappears completely.</p></entry>
    71 <entry><p>Tactile: Basic button effect and audio feedback is provided with
    68 <entry><p>Tactile: Basic button effect and audio feedback is provided with
    72 touch down and basic button effect with release events.</p></entry>
    69 touch down and basic button effect with release events.</p></entry>
    73 </row>
    70 </row>
    74 <row>
    71 <row>
    75 <entry><p>Touch down and release on <codeph>SK2</codeph> §KEY_SK2_SOFTKEY§</p></entry>
    72 <entry><p>Touch down and release on right softkey.</p></entry>
    76 <entry><p>Discards operation. </p><p>Attached application is discarded and
    73 <entry><p>Discards operation. </p><p>Attached application is discarded and
    77 displayed notification disappears completely</p></entry>
    74 displayed notification disappears completely</p></entry>
    78 <entry><p>Tactile: Basic button effect and audio feedback is provided with
    75 <entry><p>Tactile: Basic button effect and audio feedback is provided with
    79 touch down and basic button effect with release events.</p></entry>
    76 touch down and basic button effect with release events.</p></entry>
    80 </row>
    77 </row>
    92 </row>
    89 </row>
    93 </tbody>
    90 </tbody>
    94 </tgroup>
    91 </tgroup>
    95 </table>
    92 </table>
    96 <p/>
    93 <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
    94 <table id="GUID-D5917E40-42B1-461B-8722-C7AD66482078-GENID-1-10-1-6-1-1-5-1-16-1-1-2-10"><title>Default touch
    98 events for grouped soft notification</title>
    95 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*"/>
    96 <tgroup cols="3"><colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/><colspec colname="col3" colwidth="1.19*"/>
   100 <thead>
    97 <thead>
   101 <row>
    98 <row>
   102 <entry valign="top"><p>User action</p></entry>
    99 <entry valign="top"><p>User action</p></entry>
   104 <entry valign="top"><p>Feedback</p></entry>
   101 <entry valign="top"><p>Feedback</p></entry>
   105 </row>
   102 </row>
   106 </thead>
   103 </thead>
   107 <tbody>
   104 <tbody>
   108 <row>
   105 <row>
   109 <entry><p>Touch down and release on <codeph>SK2</codeph> §KEY_SK2_SOFTKEY§</p></entry>
   106 <entry><p>Touch down and release on right softkey.</p></entry>
   110 <entry><p>Discards the operation.</p><p>Grouped soft notification is discarded</p></entry>
   107 <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
   108 <entry><p>Tactile: Basic button effect and audio feedback is provided with
   112 touch down and basic button effect with release events.</p></entry>
   109 touch down and basic button effect with release events.</p></entry>
   113 </row>
   110 </row>
   114 <row>
   111 <row>
   115 <entry><p>Touch down and release on list item</p></entry>
   112 <entry><p>Touch down and release on list item</p></entry>
   116 <entry><p>Confirms the operation. </p><p>Attached application is activated,
   113 <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
   114 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>
   115 can return to the grouped soft notification list by returning to home screen.</p></entry>
   119 <entry><p>Tactile: Basic button effect and audio feedback is provided with
   116 <entry><p>Tactile: Basic button effect and audio feedback is provided with
   120 touch down and basic button effect with release events.</p></entry>
   117 touch down and basic button effect with release events.</p></entry>
   121 </row>
   118 </row>
   122 <row>
   119 <row>
   123 <entry><p>Touch down and release outside notification</p></entry>
   120 <entry><p>Touch down and release outside notification</p></entry>
   133 </row>
   130 </row>
   134 </tbody>
   131 </tbody>
   135 </tgroup>
   132 </tgroup>
   136 </table>
   133 </table>
   137 <section id="GUID-27C82CB3-9B88-4DD1-9B94-F5A948971B73"><title>Using
   134 <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
   135 soft notifications in 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>
   136 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>
   137 </conbody></concept>