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-E7EFAD50-3323-49A6-A5D9-95B95F0FBF0E" xml:lang="en"><title>Preview

    13 pop-up</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>Preview pop-up is a floating component used for displaying more detailed

    15 data about an item that has focus in the main pane.</p>

    16 <fig id="GUID-443FE00D-6678-4951-9038-07C82D10B69E">

    17 <title>Preview pop-up</title>

    18 <image href="GUID-02072A1B-6F60-457B-8F26-2B25A6EA7C5F_d0e67292_href.png" placement="inline"/>

    19 </fig>

    20 <p>The preview is displayed with a 0.6 second delay after the focus is moved

    21 (for example, scrolling down a list with the Arrow keys) to avoid too rapid

    22 and continuous flicker. The default time-out for closing the preview pop-up

    23 is the same as for the Information pop-up, but it is possible to adjust it

    24 if necessary.</p>

    25 <p>Preview pop-up contents cannot be scrolled and the component must not contain

    26 any buttons or other elements that make it appear interactive: the component

    27 is the same in both standard and touch-enabled devices and should the component

    28 be used in a standard non-touch device, its elements should not look touch-enabled.

    29 There can be a maximum of five text rows in a preview pop-up, and it is possible

    30 to place a small icon in the start of the rows. It is even possible to have

    31 more than one icon on a row instead of text, if necessary. The number of images

    32 in a single preview pop-up is limited to one, and it can be accompanied by

    33 up to two rows of text.</p>

    34 <p>Preview pop-up shows always duplicate data in a given application to ensure

    35 that the user will not miss any content or functionality even if a given product

    36 does not utilize preview pop-up (that is, it has been switched OFF). Owing

    37 to the special nature of preview pop-up, it is important to thoroughly consider

    38 its genuine usefulness in various applications. Furthermore, the component

    39 should not be confused with the Information pop-up note even though the data

    40 displayed in these two components can at times be identical.</p>

    41 <table id="GUID-77983E22-5C85-4810-83B0-F52EFC18D428"><title>Default touch

    42 events in Preview Pop-Up</title>

    43 <tgroup cols="3"><colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/><colspec colname="col3" colwidth="1.19*"/>

    44 <thead>

    45 <row>

    46 <entry valign="top"><p>User action</p></entry>

    47 <entry valign="top"><p>State change</p></entry>

    48 <entry valign="top"><p>Feedback</p></entry>

    49 </row>

    50 </thead>

    51 <tbody>

    52 <row>

    53 <entry><p>Touch down / release in Preview pop-up area</p></entry>

    54 <entry><p>Application-specific</p></entry>

    55 <entry><p>Tactile: Tactile feedback follows the component-specific functionality.</p></entry>

    56 </row>

    57 <row>

    58 <entry><p>Touch down / release outside Preview pop-up</p></entry>

    59 <entry><p>Dismisses Preview pop-up</p></entry>

    60 <entry><p>Tactile: No effect</p></entry>

    61 </row>

    62 <row>

    63 <entry><p>Touch down and hold</p></entry>

    64 <entry><p>Application-specific</p></entry>

    65 <entry><p>Tactile: Basic tactile feedback and audio feedback is provided with

    66 touch down event.</p></entry>

    67 </row>

    68 </tbody>

    69 </tgroup>

    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>

   103 </conbody></concept>