|
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-C4E728B4-3E84-49A4-83CB-DF146420D78A" xml:lang="en"><title>Stylus |
|
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 |
|
15 offer dynamic functions, and the pop-up only offers tap-enabled functions. |
|
16 The stylus pop-up menu can also be used directly on top of applications. For |
|
17 example, on an image in Browser, the stylus pop-up menu can be used for offering <uicontrol>Save |
|
18 as…</uicontrol> and similar options.</p> |
|
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 |
|
21 name or even anywhere else on the screen closes the stylus pop-up menu without |
|
22 moving the focus. </title> |
|
23 <image href="GUID-AA4FF598-36A0-4F3B-B440-14052C01EED8_d0e85434_href.png" scale="33" placement="inline"/> |
|
24 </fig> |
|
25 <p>Activation of the stylus pop-up menu can be done with a short or long tap, |
|
26 which ever suits the given application and situation the best. Background |
|
27 is not dimmed when the stylus pop-up menu is shown. The menu disappears automatically |
|
28 after six seconds (or as soon as the user selects an item or taps outside |
|
29 the pop-up area).</p> |
|
30 <p>As the purpose of the component is only to offer some primary functions |
|
31 (a maximum of six functions), the stylus pop-up menu is not a scrollable component. |
|
32 Thus it has no focus.</p> |
|
33 <section><title>Using stylus pop-up menus |
|
34 in C++ applications</title><p>The API to use for creating a stylus pop-up |
|
35 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 |
|
37 commands in a context menu</xref>.</p></section> |
|
38 </conbody></concept> |