13 pop-up</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 pop-up</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 <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 |
15 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> |
16 <fig id="GUID-443FE00D-6678-4951-9038-07C82D10B69E"> |
16 <fig id="GUID-443FE00D-6678-4951-9038-07C82D10B69E"> |
17 <title>Preview pop-up</title> |
17 <title>Preview pop-up</title> |
18 <image href="GUID-02072A1B-6F60-457B-8F26-2B25A6EA7C5F_d0e67292_href.png" placement="inline"/> |
18 <image href="GUID-02072A1B-6F60-457B-8F26-2B25A6EA7C5F_d0e62220_href.png" placement="inline"/> |
19 </fig> |
19 </fig> |
20 <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 |
21 (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 |
22 and continuous flicker. The default time-out for closing the preview pop-up |
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 |
23 is the same as for the Information pop-up, but it is possible to adjust it |
71 <note> No tactile feedback is provided with preview pop-up. Applications need |
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 |
72 to take care of tactile feedback for the interactive elements inside Preview |
73 pop-up.</note> |
73 pop-up.</note> |
74 <p/> |
74 <p/> |
75 <section id="GUID-0381A2A3-571D-4C1D-A418-AA0C71ECB681"><title>Preview pop-up |
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 |
76 in a touch interface</title><p>Preview pop-up is not a touch-only component, |
77 for displaying more detailed data about an item that has the focus in the |
77 and its basic functionality is described above. Although it is |
78 main pane. It is not a touch-only component, and its basic functionality is |
78 not recommended to place buttons or other items that appear touch-enabled |
79 described above. Although it is not recommended to place buttons or other |
79 into the preview pop-up, it is still possible to give some items touch-only |
80 items that appear touch-enabled into the preview pop-up, it is still possible |
80 functions. It is up to each application to decide whether to make use of this |
81 to give some items touch-only functions. It is up to each application to decide |
81 support in some sensible way. For example, a tap on a www hyperlink displayed |
82 whether to make use of this support in some sensible way. For example, a tap |
82 in the preview pop-up would open Browser and open the Web site in question. |
83 on a www hyperlink displayed in the preview pop-up would open Browser and |
83 However, it should be noted that using touch-enabled items in the preview |
84 open the Web site in question. However, it should be noted that using touch-enabled |
84 pop-up is an advanced, heavy-user feature.</p><p>A tap on an item in the preview |
85 items in the preview pop-up is an advanced, heavy-user feature.</p><p>A tap |
85 pop-up can also open the stylus pop-up menu, when there is no obvious direct |
86 on an item in the preview pop-up can also open the stylus pop-up menu, when |
86 function for that item. For more information, see <xref href="GUID-C4E728B4-3E84-49A4-83CB-DF146420D78A.dita">Stylus |
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> |
87 pop-up menu</xref>.</p></section> |
88 <section id="GUID-BE7B9950-53D3-4BB5-8971-4CBD0D57CE51"><title>Preview pop-up |
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 |
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 |
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, |
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 |
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 |
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 |
94 opened with a stylus, it is perfectly acceptable to make touch functions plainly |
95 touch-enabled.</p></section> |
95 touch-enabled.</p></section> |
96 <section id="GUID-AC64544E-D3D9-451C-B0EF-FF3F54B280DF"><title>Using |
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 |
97 preview pop-ups in applications</title><p>The API to use for creating the |
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 |
98 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 |
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), |
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 |
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> |
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> |
103 </conbody></concept> |