Symbian3/PDK/Source/GUID-2C0C173D-C659-4011-8B7A-8EB35E64D150.dita
author Graeme Price <GRAEME.PRICE@NOKIA.COM>
Fri, 15 Oct 2010 14:32:18 +0100
changeset 15 307f4279f433
parent 12 80ef3a206772
permissions -rw-r--r--
Initial contribution of the Adaptation Documentation.

<?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-2C0C173D-C659-4011-8B7A-8EB35E64D150" xml:lang="en"><title>Touch gestures</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>The touch gestures (finger movements on the device display area)
are interpreted using touch gesture framework provided by UI framework.
 The UI FW listens to the pointer events and notifies the client after
recognizing the gestures. The client can enable listening of desired
gestures.</p>
<p> The touch gesture framework supports the following single touch
gestures:<ul>
<li><p>Tap</p></li>
<li><p>Double tap</p></li>
<li><p>Drag</p></li>
<li><p>Flick</p></li>
<li><p>Swipe (up, down, left and right)</p></li>
</ul> Gesture Framework can provide swipe speed that can be used as
input to inertia based effects. Two finger pinch (zoom) multiple touch gesture is also recognized.</p>
<p> Additionally, there is an option to support drag and drop. It
is initiated by holding the touch position for a short time in the
same place. The holding mode is active until the user releases the
touch. </p>
<section id="GUID-8E20288C-9B08-484E-8212-040D8B47BC6F">       <title>Using touch gestures in C++ applications</title><p>The API to use
for recognizing touch gestures is Touch Gesture API.</p><p>Touch Gesture
Framework contains a pointer to a control (derived from <xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref>) where gestures are recognized. These gestures are reported to the
gesture observer. Based on the gesture interest set by the gesture
observer, <xref href="GUID-C0559E40-20E1-3D2C-A6EF-51F3E80A651E.dita"><apiname>CAknTouchGestureFw</apiname></xref> converts the pointer
events to the logical gesture.</p></section>
</conbody></concept>