|
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-E7EFAD50-3323-49A6-A5D9-95B95F0FBF0E" xml:lang="en"><title>Preview |
|
10 pop-up</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody> |
|
11 <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> |
|
13 <fig id="GUID-443FE00D-6678-4951-9038-07C82D10B69E"> |
|
14 <title>Floating preview</title> |
|
15 <image href="GUID-F07B3B53-0C4D-4472-8E00-34A4C8501C5E_d0e85372_href.png" scale="40" placement="inline"></image> |
|
16 </fig> |
|
17 <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 |
|
19 and continuous flicker. The default timeout for closing the preview pop-up |
|
20 is the same as for the Information pop-up, but it is possible to adjust it |
|
21 if necessary.</p> |
|
22 <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 |
|
24 is the same in both standard and touch-enabled devices and should the component |
|
25 be used in a standard non-touch device, its elements should not look touch-enabled. |
|
26 There can be a maximum of five text rows in a preview pop-up, and it is possible |
|
27 to place a small icon in the start of the rows. It is even possible to have |
|
28 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 |
|
30 up to two rows of text.</p> |
|
31 <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 |
|
33 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 |
|
35 its genuine usefulness in various applications. Furthermore, the component |
|
36 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> |
|
38 <section><title>Preview pop-up in a touch interface</title><p>Preview pop-up |
|
39 is a floating component used for displaying more detailed data about an item |
|
40 that has the focus in the main pane. It is not a touch-only component, and |
|
41 its basic functionality is described above. Although it is not recommended |
|
42 to place buttons or other items that appear touch-enabled into the preview |
|
43 pop-up, it is still possible to give some items touch-only functions. It is |
|
44 up to each application to decide whether to make use of this support in some |
|
45 sensible way. For example, a tap on a www hyperlink displayed in the preview |
|
46 pop-up would open Browser and open the Web site in question. However, it should |
|
47 be noted that using touch-enabled items in the preview pop-up is an advanced, |
|
48 heavy-user feature.</p><p>A tap on an item in the preview pop-up can also |
|
49 open the stylus pop-up menu, when there is no obvious direct function for |
|
50 that item. For more information, see <xref href="GUID-C4E728B4-3E84-49A4-83CB-DF146420D78A.dita">Stylus |
|
51 pop-up menu</xref>.</p></section> |
|
52 <section><title>Preview pop-up for touch only</title><p>The above section |
|
53 describes the general case for touch and the preview pop-up. There is, however, |
|
54 a variance possibility for the preview pop-up, which is to limit it strictly |
|
55 for touch. In this case, the guideline for having no buttons or other obvious |
|
56 touch items in the preview pop-up can be ignored for the most part: if the |
|
57 preview pop-up can only be opened with a stylus, it is perfectly acceptable |
|
58 to make touch functions plainly touch-enabled.</p></section> |
|
59 <section><title>Using preview pop-ups |
|
60 in C++ applications</title><p>The API to use for creating the preview pop-up |
|
61 component is the Information |
|
62 preview popup API.</p><p>Preview popups can be used in two modes: in |
|
63 the default mode where the popup is hidden automatically as a result of timeout |
|
64 or input event (either a key press or a pointer event), or in permanent mode |
|
65 where the popup stays visible until it is dismissed by the application code. </p><p>For |
|
66 implementation information, see Using |
|
67 the Information Preview Popup API. </p></section> |
|
68 </conbody></concept> |