9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-C4E728B4-3E84-49A4-83CB-DF146420D78A" xml:lang="en"><title>Stylus |
12 <concept id="GUID-C4E728B4-3E84-49A4-83CB-DF146420D78A" xml:lang="en"><title>Stylus |
13 pop-up menu</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 pop-up menu</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 <p>The stylus pop-up menu is a separate pop-up mainly used when a view cannot |
14 <p>Stylus pop-up menu is the primary menu for showing item-specific options. |
15 offer dynamic functions, and the pop-up only offers tap-enabled functions. |
15 Item-specific options are placed in the stylus pop-up menu that is activated |
16 The stylus pop-up menu can also be used directly on top of applications. For |
16 with touch down and hold on an item. It can be attached to almost all the |
17 example, on an image in Browser, the stylus pop-up menu can be used for offering <uicontrol>Save |
17 items. </p> |
18 as…</uicontrol> and similar options.</p> |
18 <fig id="GUID-45264A92-D57F-41D5-8337-0701D90C84AE"> |
19 <fig id="GUID-0C99C154-156D-4399-B8F5-811363D438E6"> |
|
20 <title>Stylus pop-up menu opened from a preview pop-up. A tap on any other |
19 <title>Stylus pop-up menu opened from a preview pop-up. A tap on any other |
21 name or even anywhere else on the screen closes the stylus pop-up menu without |
20 name or even anywhere else on the screen closes the stylus pop-up menu without |
22 moving the focus. </title> |
21 moving the focus. </title> |
23 <image href="GUID-AA4FF598-36A0-4F3B-B440-14052C01EED8_d0e85434_href.png" scale="33" placement="inline"/> |
22 <image href="GUID-70E92884-004F-43B5-B740-B0C95E8E401C_d0e95828_href.png" placement="inline"/> |
24 </fig> |
23 </fig> |
25 <p>Activation of the stylus pop-up menu can be done with a short or long tap, |
24 <p>It is a separate pop-up mainly used when a view cannot offer dynamic functions, |
26 which ever suits the given application and situation the best. Background |
25 and the pop-up only offers tap-enabled functions. The stylus pop-up menu can |
27 is not dimmed when the stylus pop-up menu is shown. The menu disappears automatically |
26 also be used directly on top of applications. For example, on an image in |
28 after six seconds (or as soon as the user selects an item or taps outside |
27 Browser, the stylus pop-up menu can be used for offering <uicontrol>Save as…</uicontrol> and |
29 the pop-up area).</p> |
28 similar options.</p> |
30 <p>As the purpose of the component is only to offer some primary functions |
29 <p>Following are the guidelines to be followed while designing the menu:</p> |
31 (a maximum of six functions), the stylus pop-up menu is not a scrollable component. |
30 <ul> |
32 Thus it has no focus.</p> |
31 <li><p>Item-specific pop-up menu should not be used with buttons and multi-selection |
33 <section><title>Using stylus pop-up menus |
32 list or grid items.</p></li> |
34 in C++ applications</title><p>The API to use for creating a stylus pop-up |
33 <li><p>Stylus pop-up menu should have only six items.</p></li> |
35 menu is the <xref href="GUID-B8BCC4F0-7F55-4728-B7EA-3280CA822C91.dita">Stylus |
34 <li><p>If used for items other than item-specific menu items, it is recommended |
|
35 to open the pop-up with touch down and hold.</p></li> |
|
36 <li><p>Stylus pop-up menu has no sub-menus.</p></li> |
|
37 <li><p>Functions that are performed via touch down and release are not duplicated |
|
38 in the stylus pop-up menu. For example, 'Open' or 'Change' should not be in |
|
39 the stylus pop-up menu.</p></li> |
|
40 </ul> |
|
41 <p> Background is not dimmed when the stylus pop-up menu is shown. The menu |
|
42 disappears automatically after six seconds (or as soon as the user selects |
|
43 an item or taps outside the pop-up area).</p> |
|
44 <p>The stylus pop-up menu is scrollable and a scrollbar is added if the number |
|
45 of items exceeds what fits the component.</p> |
|
46 <table id="GUID-28E7DE47-C3A1-4642-A9CF-6E24B824D53E"><title>Default touch |
|
47 events for Stylus pop-up menu</title> |
|
48 <tgroup cols="3"><colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/><colspec colname="col3" colwidth="1.19*"/> |
|
49 <thead> |
|
50 <row> |
|
51 <entry valign="top"><p>User action</p></entry> |
|
52 <entry valign="top"><p>State change</p></entry> |
|
53 <entry valign="top"><p>Feedback</p></entry> |
|
54 </row> |
|
55 </thead> |
|
56 <tbody> |
|
57 <row> |
|
58 <entry><p>Touch down</p></entry> |
|
59 <entry><p>No effect</p></entry> |
|
60 <entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio |
|
61 feedback is provided with touch down event.</p></entry> |
|
62 </row> |
|
63 <row> |
|
64 <entry><p>Touch release</p></entry> |
|
65 <entry><p>The item is activated.</p></entry> |
|
66 <entry><p>Highlight disappears and stylus pop-up is closed. </p><p>Tactile: |
|
67 Basic list effect is provided with touch release event.</p></entry> |
|
68 </row> |
|
69 <row> |
|
70 <entry><p>Touch down and hold</p></entry> |
|
71 <entry><p>Inactive</p></entry> |
|
72 <entry><p>Tactile: No effect</p></entry> |
|
73 </row> |
|
74 <row> |
|
75 <entry><p>Touch down and move inside the stylus pop-up</p></entry> |
|
76 <entry><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
77 and flicking</xref> events</p></entry> |
|
78 <entry><p>Tactile: Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
79 and flicking</xref> events.</p></entry> |
|
80 </row> |
|
81 <row> |
|
82 <entry><p>Touch down and move out of the stylus pop-up menu</p></entry> |
|
83 <entry><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
84 and flicking</xref> events</p></entry> |
|
85 <entry><p>Tactile: Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
86 and flicking</xref> events.</p></entry> |
|
87 </row> |
|
88 <row> |
|
89 <entry><p>Touch down and release out of menu area</p></entry> |
|
90 <entry><p>Stylus pop-up menu disappears. No selection is made.</p></entry> |
|
91 <entry><p>Tactile: Opens via long touch, provides only the increasing long |
|
92 touch effect during the touch down and hold event. No additional pop-up effect |
|
93 is provided when the menu opens.</p></entry> |
|
94 </row> |
|
95 <row> |
|
96 <entry><p>Touch down and move horizontally</p></entry> |
|
97 <entry><p>Inactive</p></entry> |
|
98 <entry><p>Highlight stays on the item that is touched down before moving horizontally. </p><p>Tactile: |
|
99 No effect</p></entry> |
|
100 </row> |
|
101 </tbody> |
|
102 </tgroup> |
|
103 </table> |
|
104 <section id="GUID-0F4419D9-0C2D-4718-8199-399412443B2C"><title>Using |
|
105 stylus pop-up menus in C++ applications</title><p>The API to use for creating |
|
106 a stylus pop-up menu is the <xref href="GUID-B8BCC4F0-7F55-4728-B7EA-3280CA822C91.dita">Stylus |
36 pop-up menu API</xref>.</p><p>For implementation information, see <xref href="GUID-8F04D882-B846-4A0D-B858-15FDA85758FA.dita">Displaying |
107 pop-up menu API</xref>.</p><p>For implementation information, see <xref href="GUID-8F04D882-B846-4A0D-B858-15FDA85758FA.dita">Displaying |
37 commands in a context menu</xref>.</p></section> |
108 commands in a context menu</xref>.</p></section> |
38 </conbody></concept> |
109 </conbody></concept> |