Symbian3/PDK/Source/GUID-2C0C173D-C659-4011-8B7A-8EB35E64D150.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Fri, 02 Jul 2010 12:51:36 +0100
changeset 11 5072524fcc79
parent 5 f345bda72bc4
child 12 80ef3a206772
permissions -rw-r--r--
Fixing terminology
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
11
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     1
<?xml version="1.0" encoding="UTF-8"?>
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     2
<!--Arbortext, Inc., 1988-2008, v.4002-->
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     3
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     4
 "concept.dtd">
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     5
<concept id="GUID-2C0C173D-C659-4011-8B7A-8EB35E64D150" xml:lang="en">
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     6
<title>Touch gestures</title>
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     7
<prolog>
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     8
<metadata><keywords></keywords></metadata>
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     9
</prolog>
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    10
<conbody>
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    11
<p>The touch gestures (finger movements on the device display area)
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    12
are interpreted using touch gesture framework provided by UI framework.
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    13
 The UI FW listens to the pointer events and notifies the client after
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    14
recognizing the gestures. The client can enable listening of desired
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    15
gestures.</p>
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    16
<p> The touch gesture framework supports the following single touch
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    17
gestures:<ul>
5
f345bda72bc4 Week 12 contribution of PDK documentation_content. See release notes for details. Fixes Bug 2054, Bug 1583, Bug 381, Bug 390, Bug 463, Bug 1897, Bug 344, Bug 1319, Bug 394, Bug 1520, Bug 1522, Bug 1892"
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents:
diff changeset
    18
<li><p>Tap</p></li>
f345bda72bc4 Week 12 contribution of PDK documentation_content. See release notes for details. Fixes Bug 2054, Bug 1583, Bug 381, Bug 390, Bug 463, Bug 1897, Bug 344, Bug 1319, Bug 394, Bug 1520, Bug 1522, Bug 1892"
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents:
diff changeset
    19
<li><p>Double tap</p></li>
f345bda72bc4 Week 12 contribution of PDK documentation_content. See release notes for details. Fixes Bug 2054, Bug 1583, Bug 381, Bug 390, Bug 463, Bug 1897, Bug 344, Bug 1319, Bug 394, Bug 1520, Bug 1522, Bug 1892"
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents:
diff changeset
    20
<li><p>Drag</p></li>
f345bda72bc4 Week 12 contribution of PDK documentation_content. See release notes for details. Fixes Bug 2054, Bug 1583, Bug 381, Bug 390, Bug 463, Bug 1897, Bug 344, Bug 1319, Bug 394, Bug 1520, Bug 1522, Bug 1892"
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents:
diff changeset
    21
<li><p>Flick</p></li>
f345bda72bc4 Week 12 contribution of PDK documentation_content. See release notes for details. Fixes Bug 2054, Bug 1583, Bug 381, Bug 390, Bug 463, Bug 1897, Bug 344, Bug 1319, Bug 394, Bug 1520, Bug 1522, Bug 1892"
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents:
diff changeset
    22
<li><p>Swipe (up, down, left and right)</p></li>
11
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    23
</ul> Gesture Framework can provide swipe speed that can be used as
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    24
input to inertia based effects. Two finger pinch (zoom) multiple <?Pub
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    25
Caret?>touch gesture is also recognized.</p>
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    26
<p> Additionally, there is an option to support drag and drop. It
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    27
is initiated by holding the touch position for a short time in the
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    28
same place. The holding mode is active until the user releases the
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    29
touch. </p>
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    30
<section id="GUID-8E20288C-9B08-484E-8212-040D8B47BC6F">       <title
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    31
>Using touch gestures in C++ applications</title><p>The API to use
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    32
for recognizing touch gestures is Touch Gesture API.</p><p>Touch Gesture
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    33
Framework contains a pointer to a control (derived from <xref
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    34
href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    35
></xref>) where gestures are recognized. These gestures are reported
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    36
to the gesture observer. Based on the gesture interest set by the
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    37
gesture observer, <xref
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    38
href="GUID-C0559E40-20E1-3D2C-A6EF-51F3E80A651E.dita"><apiname>CAknTouchGestureFw</apiname
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    39
></xref> converts the pointer events to the logical gesture.</p></section>
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    40
</conbody>
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    41
</concept>
5072524fcc79 Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    42
<?Pub *0000001962?>