|
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> |