<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-8F04D882-B846-4A0D-B858-15FDA85758FA" xml:lang="en"><title>Displaying

commands in a stylus pop-up menu</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>To use a stylus pop-up menu in your application, implement the following

use cases: </p>

<ul>

<li><p><xref href="GUID-D0F6E95B-B35A-4EA1-8CC3-D86D1E0E6DD3.dita">Creating stylus

pop-up menu</xref> </p></li>

<li><p><xref href="GUID-405F7AB8-0F0E-4171-95E6-3524D76917DE.dita">Handling stylus

pop-up menu events and commands</xref></p></li>

<li><p><xref href="GUID-2045A3D6-88DB-41ED-905B-079A8DC35E24.dita">Handling user

command selection</xref></p></li>

<li><p><xref href="GUID-4A66B46E-8A23-42E4-ADAD-B124A36B180A.dita">Showing and

hiding stylus pop-up menu</xref></p></li>

<li><p><xref href="GUID-7B863846-7666-4FBF-90B2-52F847710C45.dita">Adding and removing

menu items</xref></p></li>

</ul>

<p><draft-comment time="2008-05-15T13:43" translate="no">We need to provide more clarity

on the required order of implementing the use cases and clarify whether there

are alternative approaches for achieving the same results.</draft-comment></p>

<p>The following use cases are optional, allowing you to set additional properties

for your stylus pop-up menu: </p>

<ul>

<li><p><xref href="GUID-D932955F-30AA-40C7-9653-63E48C38BECB.dita">Setting stylus

pop-up menu position</xref></p></li>

<li><p><xref href="GUID-494AF38D-CE0C-4B4C-BE44-2FC7482F4B7B.dita">Hiding and showing

stylus pop-up menu items</xref></p></li>

</ul>

<section id="GUID-2A041837-914E-4117-A1C5-E975B738EC63"><title>Implementation

file</title><p>The implementation file for the Stylus pop-up menu API is <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/aknstyluspopupmenu_8h-source.html" format="application/java-archive"><codeph>aknstyluspopupmenu.h</codeph></xref>.</p></section>

</conbody><related-links>

<link href="GUID-B8BCC4F0-7F55-4728-B7EA-3280CA822C91.dita"><linktext>Stylus pop-up

menu API description</linktext></link>

<link href="GUID-C4E728B4-3E84-49A4-83CB-DF146420D78A.dita"><linktext>Look and

feel guidelines for the stylus pop-up menu</linktext></link>