1 <?xml version="1.0" encoding="utf-8"?> |
1 <?xml version="1.0" encoding="UTF-8"?> |
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
2 <!--Arbortext, Inc., 1988-2008, v.4002--> |
3 <!-- This component and the accompanying materials are made available under the terms of the License |
3 <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" |
4 "Eclipse Public License v1.0" which accompanies this distribution, |
4 "concept.dtd"> |
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
5 <concept id="GUID-2C0C173D-C659-4011-8B7A-8EB35E64D150" xml:lang="en"> |
6 <!-- Initial Contributors: |
6 <title>Touch gestures</title> |
7 Nokia Corporation - initial contribution. |
7 <prolog> |
8 Contributors: |
8 <metadata><keywords></keywords></metadata> |
9 --> |
9 </prolog> |
10 <!DOCTYPE concept |
10 <conbody> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 <p>The touch gestures (finger movements on the device display area) |
12 <concept id="GUID-2C0C173D-C659-4011-8B7A-8EB35E64D150" xml:lang="en"><title>Touch |
12 are interpreted using touch gesture framework provided by UI framework. |
13 gestures</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 The UI FW listens to the pointer events and notifies the client after |
14 <p>The touch gestures (finger movements on the device display area) are interpreted |
14 recognizing the gestures. The client can enable listening of desired |
15 using touch gesture framework provided by UI framework. The UI FW listens |
15 gestures.</p> |
16 to the pointer events and notifies the client after recognizing the gestures. |
16 <p> The touch gesture framework supports the following single touch |
17 The client can enable listening of desired gestures.</p> |
17 gestures:<ul> |
18 <p> The touch gesture framework supports the following single touch gestures:<ul> |
|
19 <li><p>Tap</p></li> |
18 <li><p>Tap</p></li> |
20 <li><p>Double tap</p></li> |
19 <li><p>Double tap</p></li> |
21 <li><p>Drag</p></li> |
20 <li><p>Drag</p></li> |
22 <li><p>Flick</p></li> |
21 <li><p>Flick</p></li> |
23 <li><p>Swipe (up, down, left and right)</p></li> |
22 <li><p>Swipe (up, down, left and right)</p></li> |
24 </ul> Gesture Framework can provide swipe speed that can be used as input |
23 </ul> Gesture Framework can provide swipe speed that can be used as |
25 to inertia based effects. Two finger pinch (zoom) multi-touch gesture is also |
24 input to inertia based effects. Two finger pinch (zoom) multiple <?Pub |
26 recognized.</p> |
25 Caret?>touch gesture is also recognized.</p> |
27 <p> Additionally, there is an option to support drag and drop. It is initiated |
26 <p> Additionally, there is an option to support drag and drop. It |
28 by holding the touch position for a short time in the same place. The holding |
27 is initiated by holding the touch position for a short time in the |
29 mode is active until the user releases the touch. </p> |
28 same place. The holding mode is active until the user releases the |
30 <section id="GUID-8E20288C-9B08-484E-8212-040D8B47BC6F"> <title>Using |
29 touch. </p> |
31 touch gestures in C++ applications</title><p>The API to use for recognizing |
30 <section id="GUID-8E20288C-9B08-484E-8212-040D8B47BC6F"> <title |
32 touch gestures is Touch Gesture API.</p><p>Touch Gesture Framework contains |
31 >Using touch gestures in C++ applications</title><p>The API to use |
33 a pointer to a control (derived from <xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref>) where |
32 for recognizing touch gestures is Touch Gesture API.</p><p>Touch Gesture |
34 gestures are recognized. These gestures are reported to the gesture observer. |
33 Framework contains a pointer to a control (derived from <xref |
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 |
34 href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname |
36 the pointer events to the logical gesture.</p></section> |
35 ></xref>) where gestures are recognized. These gestures are reported |
37 </conbody></concept> |
36 to the gesture observer. Based on the gesture interest set by the |
|
37 gesture observer, <xref |
|
38 href="GUID-C0559E40-20E1-3D2C-A6EF-51F3E80A651E.dita"><apiname>CAknTouchGestureFw</apiname |
|
39 ></xref> converts the pointer events to the logical gesture.</p></section> |
|
40 </conbody> |
|
41 </concept> |
|
42 <?Pub *0000001962?> |