|
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-B8BCC4F0-7F55-4728-B7EA-3280CA822C91" xml:lang="en"><title>Stylus |
|
13 pop-up menu API</title><shortdesc>The Stylus pop-up menu API is used for displaying commands in a |
|
14 context menu the user can access by tapping an item on the device screen.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
15 <fig id="GUID-69B92ECC-A4D7-4B17-A5EB-AED6E545DB93"> |
|
16 <title>Stylus pop-up menu displayed in a preview pop-up</title> |
|
17 <image href="GUID-FD21D8B1-EB37-409A-9158-19DBBF1A67B7_d0e78000_href.png" scale="75" placement="inline"/> |
|
18 </fig> |
|
19 <p>A stylus pop up menu (<codeph>CAknStylusPopUpMenu</codeph>, defined in <codeph>AknStylusPopUpMenu.h</codeph>) |
|
20 is a floating menu component that contains stylus-specific menu content. As |
|
21 the name implies, the stylus pop up menu is meant to be used only with the |
|
22 stylus by tapping a stylus interactive area. The pop-up menu is displayed |
|
23 near the tapping position. </p> |
|
24 <p>It is the application’s responsibility to create the stylus pop up menu |
|
25 and handle the actions its menu items trigger.</p> |
|
26 <p>For look and feel guidelines on the stylus pop-up menu, see the <xref href="GUID-C4E728B4-3E84-49A4-83CB-DF146420D78A.dita">stylus |
|
27 pop-up menu UI component description</xref>.</p> |
|
28 <p>For implementation information, see <xref href="GUID-8F04D882-B846-4A0D-B858-15FDA85758FA.dita">Displaying |
|
29 commands in a context menu</xref>.</p> |
|
30 <p>For the Stylus pop-up menu API classes and header files, see Classes and |
|
31 Definitions.</p> |
|
32 <section id="GUID-B08E958B-0FCC-4327-96D8-39055A2DB9D8"><title>Constraints</title><p>This |
|
33 API is valid for touch-enabled Symbian platforms.</p></section> |
|
34 <section id="GUID-731474BF-1AD5-4450-8A57-18B674ECAE09"><title>Emulator support</title><p>This |
|
35 API is fully supported in the WINS/WINSCW emulator environment.</p></section> |
|
36 </conbody><related-links> |
|
37 <linklist><title>Related APIs</title> |
|
38 <link format="html" href="specs/guides/Information_Preview_Popup_API_Specification/Information_Preview_Popup_API_Specification.html" scope="peer"><linktext>Information preview popup API</linktext> |
|
39 <desc> for creating a preview pop-up from which the stylus pop-up menu can |
|
40 be launched</desc> |
|
41 </link> |
|
42 </linklist> |
|
43 </related-links></concept> |