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-2C0C173D-C659-4011-8B7A-8EB35E64D150" xml:lang="en"><title>Touch

    13 gestures</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>The touch gestures (finger movements on the device display area) are interpreted

    15 using touch gesture framework provided by UI framework.  The UI FW listens

    16 to the pointer events and notifies the client after recognizing the gestures.

    17 The client can enable listening of desired gestures.</p>

    18 <p> The touch gesture framework supports the following single touch gestures:<ul>

    19 <li><p>Tap</p></li>

    20 <li><p>Double tap</p></li>

    21 <li><p>Drag</p></li>

    22 <li><p>Flick</p></li>

    23 <li><p>Swipe (up, down, left and right)</p></li>

    24 </ul> Gesture Framework can provide swipe speed that can be used as input

    25 to inertia based effects. Two finger pinch (zoom) multi-touch gesture is also

    26 recognized.</p>

    27 <p> Additionally, there is an option to support drag and drop. It is initiated

    28 by holding the touch position for a short time in the same place. The holding

    29 mode is active until the user releases the touch. </p>

    30 <section id="GUID-8E20288C-9B08-484E-8212-040D8B47BC6F">       <title>Using

    31 touch gestures in C++ applications</title><p>The API to use for recognizing

    32 touch gestures is Touch Gesture API.</p><p>Touch Gesture Framework contains

    33 a pointer to a control (derived from <xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref>) where

    34 gestures are recognized. These gestures are reported to the gesture observer.

    35 Based on the gesture interest set by the gesture observer, <xref href="GUID-C0559E40-20E1-3D2C-A6EF-51F3E80A651E.dita"><apiname>CAknTouchGestureFw</apiname></xref> converts

    36 the pointer events to the logical gesture.</p></section>

    37 </conbody></concept>