|
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-5B9F25B5-5FE1-4E38-BC8D-A0273F458C36" xml:lang="en"><title>Discreet |
|
13 pop-up</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>Discreet pop-up component displays notifications without blocking ongoing |
|
15 task flows in the UI. When discreet pop-up is displayed, the background is |
|
16 not dimmed and the user can continue interacting with the underlying application |
|
17 normally. Discreet pop-up can contain an icon and a maximum of two rows of |
|
18 text. Pop-up can have simple touch interaction, for example, tapping the pop-up |
|
19 can open the application. </p> |
|
20 <p>Discreet pop-up can be used to replace following note types:<ul> |
|
21 <li><p>Error note</p></li> |
|
22 <li><p>Warning note</p></li> |
|
23 <li><p>Information note</p></li> |
|
24 <li><p>Confirmation note</p></li> |
|
25 </ul>Discreet pop-up does not replace wait notes, progress notes or the soft |
|
26 notifications in the home screen. Application can have soft notification on |
|
27 the home screen and use discreet pop-up to display information of the events |
|
28 in other parts of the UI.</p> |
|
29 <p>Discreet pop-ups can be displayed in touch and non-touch devices. For non-touch |
|
30 devices, the touch functionality of the component is disabled.</p> |
|
31 <fig id="GUID-B96EA28D-1BA7-4082-89C5-FD5E4549B0DB"> |
|
32 <title>Discreet pop-up</title> |
|
33 <image href="GUID-EDC39EFF-B633-41DE-93A4-A52D2E7A4A64_d0e94991_href.png" placement="inline"/> |
|
34 </fig> |
|
35 <p>Based on the purpose of use, there are two types of discreet pop-ups:<ul> |
|
36 <li><p><b>Global discreet pop-ups</b> - they are displayed irrespective of |
|
37 the active application (always displayed on the top of any active application). </p></li> |
|
38 <li><p><b>Local discreet pop-ups</b> - they are displayed only if the application |
|
39 displaying the note is on the foreground. </p></li> |
|
40 </ul></p> |
|
41 <note> New discreet pop-up always overrides old one except local pop-up can |
|
42 never override global pop-up.</note> |
|
43 <table id="GUID-D0E86336-C66C-4833-9E2B-55579889C914"><title>Default touch |
|
44 events in Discreet pop-up.</title> |
|
45 <tgroup cols="3"><colspec colname="col1" colwidth="0.90*"/><colspec colname="col2" colwidth="0.97*"/><colspec colname="col3" colwidth="1.15*"/> |
|
46 <thead> |
|
47 <row> |
|
48 <entry valign="top"><p>User action</p></entry> |
|
49 <entry valign="top"><p>State change</p></entry> |
|
50 <entry valign="top"><p>Tactile feedback</p></entry> |
|
51 </row> |
|
52 </thead> |
|
53 <tbody> |
|
54 <row> |
|
55 <entry><p>Touch down and release on discreet pop-up</p></entry> |
|
56 <entry><p>Performs the pop-up specific action, if any is defined. Else, pop-up |
|
57 is dismissed.</p></entry> |
|
58 <entry><p>If tap performs an action, then basic list effect and audio feedback |
|
59 is provided with touch down and basic list effect on release events. If pop-up |
|
60 is dismissed, then touch down provides pop-up effect.</p></entry> |
|
61 </row> |
|
62 <row> |
|
63 <entry><p>Touch down and release outside Discreet pop-up area</p></entry> |
|
64 <entry><p>Application-specific. No effect on pop-up</p></entry> |
|
65 <entry><p>Context specific</p></entry> |
|
66 </row> |
|
67 <row> |
|
68 <entry><p>Touch down and hold on discreet pop-up</p></entry> |
|
69 <entry><p>Pop-up is displayed on the screen until the user releases the finger |
|
70 and the pop-up specific action is performed, or pop-up is dismissed if no |
|
71 action defined. In case pop-up is replaced with another discreet pop-up |
|
72 while touch down action, touch release has no effect.</p></entry> |
|
73 <entry><p><ul> |
|
74 <li><p>Basic list effect and audio feedback is provided with touch down event.</p></li> |
|
75 <li><p>If touch release performs an action, then basic list effect is provided |
|
76 with it. If it closes the pop-up, then pop-up effect is provided.</p></li> |
|
77 <li><p>If there is no action defined for touch release, then no tactile feedback |
|
78 on touch release is provided.</p></li> |
|
79 </ul> </p></entry> |
|
80 </row> |
|
81 </tbody> |
|
82 </tgroup> |
|
83 </table> |
|
84 <section id="GUID-1019914A-731E-4185-9D83-E9DF34976257"><title>Using discreet |
|
85 pop-ups in C++ applications</title>The API to use for the discreet pop-up |
|
86 is the Discreet Pop-up API. </section> |
|
87 <section id="GUID-17690B13-0C47-49E3-893C-98B371AD5230">To use a discreet |
|
88 pop-up in the application, an instance of <xref href="GUID-4C38C9A4-6518-3994-AE3B-CBE49C22B337.dita"><apiname>CAknDiscreetPopup</apiname></xref> need |
|
89 not be created; only a static call is required to display the pop-up. The |
|
90 UI framework handles the creation and destruction of <xref href="GUID-4C38C9A4-6518-3994-AE3B-CBE49C22B337.dita"><apiname>CAknDiscreetPopup</apiname></xref> instances. </section> |
|
91 </conbody></concept> |