2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
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 |
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, |
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". --> |
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
6 <!-- Initial Contributors: |
6 <!-- Initial Contributors: |
7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-E7EFAD50-3323-49A6-A5D9-95B95F0FBF0E" xml:lang="en"><title>Preview |
9 --> |
10 pop-up</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody> |
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-E7EFAD50-3323-49A6-A5D9-95B95F0FBF0E" xml:lang="en"><title>Preview |
|
13 pop-up</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
11 <p>Preview pop-up is a floating component used for displaying more detailed |
14 <p>Preview pop-up is a floating component used for displaying more detailed |
12 data about an item that has focus in the main pane.</p> |
15 data about an item that has focus in the main pane.</p> |
13 <fig id="GUID-443FE00D-6678-4951-9038-07C82D10B69E"> |
16 <fig id="GUID-443FE00D-6678-4951-9038-07C82D10B69E"> |
14 <title>Floating preview</title> |
17 <title>Preview pop-up</title> |
15 <image href="GUID-F07B3B53-0C4D-4472-8E00-34A4C8501C5E_d0e85372_href.png" scale="40" placement="inline"></image> |
18 <image href="GUID-02072A1B-6F60-457B-8F26-2B25A6EA7C5F_d0e95168_href.png" placement="inline"/> |
16 </fig> |
19 </fig> |
17 <p>The preview is displayed with a 0.6 second delay after the focus is moved |
20 <p>The preview is displayed with a 0.6 second delay after the focus is moved |
18 (for example, scrolling down a list with the Arrow keys) to avoid too rapid |
21 (for example, scrolling down a list with the Arrow keys) to avoid too rapid |
19 and continuous flicker. The default timeout for closing the preview pop-up |
22 and continuous flicker. The default time-out for closing the preview pop-up |
20 is the same as for the Information pop-up, but it is possible to adjust it |
23 is the same as for the Information pop-up, but it is possible to adjust it |
21 if necessary.</p> |
24 if necessary.</p> |
22 <p>Preview pop-up contents cannot be scrolled and the component must not contain |
25 <p>Preview pop-up contents cannot be scrolled and the component must not contain |
23 any buttons or other elements that make it appear interactive: the component |
26 any buttons or other elements that make it appear interactive: the component |
24 is the same in both standard and touch-enabled devices and should the component |
27 is the same in both standard and touch-enabled devices and should the component |
28 more than one icon on a row instead of text, if necessary. The number of images |
31 more than one icon on a row instead of text, if necessary. The number of images |
29 in a single preview pop-up is limited to one, and it can be accompanied by |
32 in a single preview pop-up is limited to one, and it can be accompanied by |
30 up to two rows of text.</p> |
33 up to two rows of text.</p> |
31 <p>Preview pop-up shows always duplicate data in a given application to ensure |
34 <p>Preview pop-up shows always duplicate data in a given application to ensure |
32 that the user will not miss any content or functionality even if a given product |
35 that the user will not miss any content or functionality even if a given product |
33 does not utilize preview pop-up (that is, it has been switched off). Owing |
36 does not utilize preview pop-up (that is, it has been switched OFF). Owing |
34 to the special nature of preview pop-up, it is important to thoroughly consider |
37 to the special nature of preview pop-up, it is important to thoroughly consider |
35 its genuine usefulness in various applications. Furthermore, the component |
38 its genuine usefulness in various applications. Furthermore, the component |
36 should not be confused with the Information pop-up note even though the data |
39 should not be confused with the Information pop-up note even though the data |
37 displayed in these two components can at times be identical.</p> |
40 displayed in these two components can at times be identical.</p> |
38 <section><title>Preview pop-up in a touch interface</title><p>Preview pop-up |
41 <table id="GUID-77983E22-5C85-4810-83B0-F52EFC18D428"><title>Default touch |
39 is a floating component used for displaying more detailed data about an item |
42 events in Preview Pop-Up</title> |
40 that has the focus in the main pane. It is not a touch-only component, and |
43 <tgroup cols="3"><colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/><colspec colname="col3" colwidth="1.19*"/> |
41 its basic functionality is described above. Although it is not recommended |
44 <thead> |
42 to place buttons or other items that appear touch-enabled into the preview |
45 <row> |
43 pop-up, it is still possible to give some items touch-only functions. It is |
46 <entry valign="top"><p>User action</p></entry> |
44 up to each application to decide whether to make use of this support in some |
47 <entry valign="top"><p>State change</p></entry> |
45 sensible way. For example, a tap on a www hyperlink displayed in the preview |
48 <entry valign="top"><p>Feedback</p></entry> |
46 pop-up would open Browser and open the Web site in question. However, it should |
49 </row> |
47 be noted that using touch-enabled items in the preview pop-up is an advanced, |
50 </thead> |
48 heavy-user feature.</p><p>A tap on an item in the preview pop-up can also |
51 <tbody> |
49 open the stylus pop-up menu, when there is no obvious direct function for |
52 <row> |
50 that item. For more information, see <xref href="GUID-C4E728B4-3E84-49A4-83CB-DF146420D78A.dita">Stylus |
53 <entry><p>Touch down / release in Preview pop-up area</p></entry> |
51 pop-up menu</xref>.</p></section> |
54 <entry><p>Application-specific</p></entry> |
52 <section><title>Preview pop-up for touch only</title><p>The above section |
55 <entry><p>Tactile: Tactile feedback follows the component-specific functionality.</p></entry> |
53 describes the general case for touch and the preview pop-up. There is, however, |
56 </row> |
54 a variance possibility for the preview pop-up, which is to limit it strictly |
57 <row> |
55 for touch. In this case, the guideline for having no buttons or other obvious |
58 <entry><p>Touch down / release outside Preview pop-up</p></entry> |
56 touch items in the preview pop-up can be ignored for the most part: if the |
59 <entry><p>Dismisses Preview pop-up</p></entry> |
57 preview pop-up can only be opened with a stylus, it is perfectly acceptable |
60 <entry><p>Tactile: No effect</p></entry> |
58 to make touch functions plainly touch-enabled.</p></section> |
61 </row> |
59 <section><title>Using preview pop-ups |
62 <row> |
60 in C++ applications</title><p>The API to use for creating the preview pop-up |
63 <entry><p>Touch down and hold</p></entry> |
61 component is the Information |
64 <entry><p>Application-specific</p></entry> |
62 preview popup API.</p><p>Preview popups can be used in two modes: in |
65 <entry><p>Tactile: Basic tactile feedback and audio feedback is provided with |
63 the default mode where the popup is hidden automatically as a result of timeout |
66 touch down event.</p></entry> |
64 or input event (either a key press or a pointer event), or in permanent mode |
67 </row> |
65 where the popup stays visible until it is dismissed by the application code. </p><p>For |
68 </tbody> |
66 implementation information, see Using |
69 </tgroup> |
67 the Information Preview Popup API. </p></section> |
70 </table> |
|
71 <note> No tactile feedback is provided with preview pop-up. Applications need |
|
72 to take care of tactile feedback for the interactive elements inside Preview |
|
73 pop-up.</note> |
|
74 <p/> |
|
75 <section id="GUID-0381A2A3-571D-4C1D-A418-AA0C71ECB681"><title>Preview pop-up |
|
76 in a touch interface</title><p>Preview pop-up is a floating component used |
|
77 for displaying more detailed data about an item that has the focus in the |
|
78 main pane. It is not a touch-only component, and its basic functionality is |
|
79 described above. Although it is not recommended to place buttons or other |
|
80 items that appear touch-enabled into the preview pop-up, it is still possible |
|
81 to give some items touch-only functions. It is up to each application to decide |
|
82 whether to make use of this support in some sensible way. For example, a tap |
|
83 on a www hyperlink displayed in the preview pop-up would open Browser and |
|
84 open the Web site in question. However, it should be noted that using touch-enabled |
|
85 items in the preview pop-up is an advanced, heavy-user feature.</p><p>A tap |
|
86 on an item in the preview pop-up can also open the stylus pop-up menu, when |
|
87 there is no obvious direct function for that item. For more information, see <xref href="GUID-C4E728B4-3E84-49A4-83CB-DF146420D78A.dita">Stylus pop-up menu</xref>.</p></section> |
|
88 <section id="GUID-BE7B9950-53D3-4BB5-8971-4CBD0D57CE51"><title>Preview pop-up |
|
89 for touch only</title><p>The above section describes the general case for |
|
90 touch and the preview pop-up. There is, however, a variance possibility for |
|
91 the preview pop-up, which is to limit it strictly for touch. In this case, |
|
92 the guideline for having no buttons or other obvious touch items in the preview |
|
93 pop-up can be ignored for the most part: if the preview pop-up can only be |
|
94 opened with a stylus, it is perfectly acceptable to make touch functions plainly |
|
95 touch-enabled.</p></section> |
|
96 <section id="GUID-AC64544E-D3D9-451C-B0EF-FF3F54B280DF"><title>Using |
|
97 preview pop-ups in C++ applications</title><p>The API to use for creating |
|
98 the preview pop-up component is the <xref format="html" href="specs/Guides/Information_Preview_Popup_API_Specification/Information_Preview_Popup_API_Specification.html" scope="peer">Information preview pop-up API</xref>.</p><p>Preview pop-ups |
|
99 can be used in two modes: in the default mode where the pop-up is hidden automatically |
|
100 as a result of time-out or input event (either a key press or a pointer event), |
|
101 or in permanent mode where the pop-up stays visible until it is dismissed |
|
102 by the application code. </p><p>For implementation information, see <xref format="html" href="specs/Guides/Information_Preview_Popup_API_Specification/Information_Preview_Popup_API_Specification.html#Information_Preview_Popup_API_Specification.topic3" scope="peer">Using the Information Preview Pop-up API</xref>. </p></section> |
68 </conbody></concept> |
103 </conbody></concept> |