<?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-A15EDC87-A6EF-40D8-AA78-B52449465FEA" xml:lang="en"><title>Receiving

long-tap events</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>To  receive long-tap events in your application using the Touch UI utilities

API, follow the steps below:</p>

<ol>

<li id="GUID-4726E563-99AA-42E8-8AED-63BC9F176A83"><p>Link the Avkon libraries <codeph>avkon.lib</codeph> and <codeph>eikcoctl.lib</codeph> to

the project file of the application.</p></li>

<li id="GUID-95DE053E-A494-4C33-8FDB-125C77370EC1"><p>Provide an observer

class that implements the <codeph>MAknLongTapDetectorCallBack</codeph> interface.</p></li>

<li id="GUID-3E2B0808-78F8-48B6-8A58-B1A41C8DB5D6"><p>Create an instance of

the class <codeph>CAknLongTapDetector</codeph> and pass pointer events to

the long-tap detector.</p></li>

<li id="GUID-C7E73EDE-6BC3-4E51-9E18-675FD3B32881"><p>Receive long-tap events

through the observer interface.</p></li>

<li id="GUID-04839B40-D170-484E-A4BC-C724FB715814"><p>Delete the long-tap

detector.</p></li>

</ol>

<p>Use cases for the long-tap detector are shown in the figure below.</p>

<fig id="GUID-1439445E-81AB-4AA4-86E0-00F53CD46D8F">

<title>Touch UI utilities API use cases</title>

<image href="GUID-B4834A49-587E-41AD-B0D3-0622B173B2AD_d0e50755_href.png" scale="70" placement="inline"/>

</fig>

<p>To use the Touch UI utilities long-tap detector in your application, implement

the following use cases.</p>

<ul>

<li><p><xref href="GUID-4102F39E-6215-44AD-9E30-6D8E86114D7D.dita">Creating the

long-tap detector</xref></p></li>

<li><p><xref href="GUID-C0C93B8A-C63C-424E-9C30-5D69C1578660.dita">Handling long-tap

events</xref></p></li>

<li><p><xref href="GUID-96228425-F2C8-4767-95AD-520C655B73C5.dita">Deleting long-tap

detector</xref></p></li>

</ul>

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

for your long-tap detector.</p>

<ul>

<li><p><xref href="GUID-92281C52-4F2E-4D9A-9D5A-E0C5F0433339.dita">Enabling and

disabling the long-tap detector</xref></p></li>

<li><p><xref href="GUID-BEA5E4F1-B355-47A1-99DC-8E8EDB7B1CB3.dita">Setting the

time after which the long-tap event is sent</xref></p></li>

<li><p><xref href="GUID-BF3767E9-054E-4894-9216-00866FC9C3D8.dita">Setting the

time before the long-tap animation starts</xref></p></li>

</ul>

</conbody></concept>