author | Dominic Pinkman <dominic.pinkman@nokia.com> |
Fri, 02 Jul 2010 12:51:36 +0100 | |
changeset 11 | 5072524fcc79 |
parent 9 | 59758314f811 |
child 12 | 80ef3a206772 |
permissions | -rw-r--r-- |
11
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
1 |
<?xml version="1.0" encoding="UTF-8"?> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
2 |
<!--Arbortext, Inc., 1988-2008, v.4002--> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
3 |
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
4 |
"concept.dtd"> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
5 |
<concept id="GUID-C60DC070-572B-5960-B394-550426FDB909" xml:lang="en"> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
6 |
<title> Advanced Pointer Tutorial</title> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
7 |
<shortdesc>This tutorial provides step-by-step instructions and sample |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
8 |
code to help you write applications using advanced pointers. </shortdesc> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
9 |
<prolog> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
10 |
<metadata><keywords></keywords></metadata> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
11 |
</prolog> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
12 |
<conbody> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
13 |
<p> <b>Variant</b>: <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
14 |
href="GUID-D93978BE-11A3-5CE3-B110-1DEAA5AD566C.dita">ScreenPlay</xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
15 |
>. <b>Target audience</b>: Application developers. </p> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
16 |
<section><title>Required background </title> <p>This topic builds |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
17 |
on the material in the following topics: </p> <ul> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
18 |
<li id="GUID-C4209FBD-3860-5F4B-8458-87D22D483953"><p><xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
19 |
href="GUID-9C269F45-F160-5A4B-ABF8-896D2A538E3B.dita">Advanced Pointer |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
20 |
Overview</xref> </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
21 |
<li id="GUID-9D3C3B31-F43A-5201-A1EC-A1F2848CFF43"><p><xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
22 |
href="GUID-9AD75103-CD56-5279-B639-5CA2BBF979B5.dita">Advanced Pointer |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
23 |
States and Event Communication</xref> </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
24 |
</ul> </section> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
25 |
<section><title>Using advanced pointers</title> <p>This topic covers |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
26 |
the following: </p> <ul> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
27 |
<li id="GUID-C3AD43AA-09C0-5BA2-8496-5B87D40C89F5"><p><xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
28 |
href="GUID-C60DC070-572B-5960-B394-550426FDB909.dita#GUID-C60DC070-572B-5960-B394-550426FDB909/GUID-8CBE862B-0C1D-5088-89B7-9B3EC898E4FC" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
29 |
>Enabling multiple pointers in a window</xref> </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
30 |
<li id="GUID-177323F2-55C6-56D9-B3D2-A8DDACF69E10"><p><xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
31 |
href="GUID-C60DC070-572B-5960-B394-550426FDB909.dita#GUID-C60DC070-572B-5960-B394-550426FDB909/GUID-C026DAB9-C11C-5D29-A1EA-6730E914250F" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
32 |
>Getting Z coordinates from TPointerEvent</xref> </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
33 |
<li id="GUID-91CEA92C-A692-5853-96F0-625A76B7DC8D"><p><xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
34 |
href="GUID-C60DC070-572B-5960-B394-550426FDB909.dita#GUID-C60DC070-572B-5960-B394-550426FDB909/GUID-B7057F69-191F-5AA4-8C61-EBECE66D92F6" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
35 |
> Pinch zooming</xref> </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
36 |
</ul> </section> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
37 |
<section id="GUID-8CBE862B-0C1D-5088-89B7-9B3EC898E4FC"><title>Enabling |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
38 |
multiple pointers in a window</title> <ol |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
39 |
id="GUID-210D17A8-4869-5F9B-B71C-672101AC591C"> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
40 |
<li id="GUID-81A2AC5C-7837-5216-8F47-FC5959C27522"><p> <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
41 |
href="GUID-637F82AF-0CF9-3C85-834D-7C1A0866DF87.dita"><apiname>RWindow</apiname |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
42 |
></xref> provides a handle to a standard window. Call <codeph>RWindow</codeph |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
43 |
> to create an instance of a window. </p> <codeblock |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
44 |
id="GUID-0E31C3F6-3719-5F16-9F74-C405850604B8" xml:space="preserve" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
45 |
> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
46 |
RWindow window(ws); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
47 |
|
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
48 |
User::LeaveIfError(window.Construct(wg, reinterpret_cast<TUint32>(&wg) + 1)); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
49 |
</codeblock> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
50 |
<li id="GUID-B67D3702-1A8F-5C6A-AB0F-FEA7C4D04A07"><p>Call <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
51 |
href="GUID-683603DD-F3D3-3193-BEB3-8236C7DE7F79.dita#GUID-683603DD-F3D3-3193-BEB3-8236C7DE7F79/GUID-05293539-F1B0-3C7D-BB14-3FD42F23D5C8" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
52 |
><apiname>RWindow::EnableAdvancedPointers()</apiname></xref> to enable |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
53 |
advanced pointers. Then call <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
54 |
href="GUID-1460DD8F-9AA1-3B99-8FFD-F309959CCA34.dita#GUID-1460DD8F-9AA1-3B99-8FFD-F309959CCA34/GUID-4E02165A-DFCC-3D18-BB18-18726B28E90A" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
55 |
><apiname>RWindowBase::Activate()</apiname></xref> to display the |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
56 |
window and enable the window to receive events. <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
57 |
href="GUID-683603DD-F3D3-3193-BEB3-8236C7DE7F79.dita"><apiname>RWindow</apiname |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
58 |
></xref> inherits from <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
59 |
href="GUID-1460DD8F-9AA1-3B99-8FFD-F309959CCA34.dita"><apiname>RWindowBase</apiname |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
60 |
></xref>, so you can call the <codeph>Activate()</codeph> function |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
61 |
on <codeph>RWindow</codeph>. </p> <codeblock |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
62 |
id="GUID-DB2FB570-2BB0-5C5F-9E4F-076D6A0E469E" xml:space="preserve" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
63 |
> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
64 |
window.EnableAdvancedPointers(); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
65 |
window.Activate(); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
66 |
</codeblock> <p>When an application needs to receive advanced pointer |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
67 |
events in a window, it must call <codeph>RWindowBase::EnableAdvancedPointers()</codeph |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
68 |
> for the window <i>before</i> it is activated. </p> <p>If advanced |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
69 |
pointers are not enabled f<?Pub Caret?>or a window, it receives only |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
70 |
standard <xref href="GUID-1FFA0073-3D83-388E-A824-08C31F90CC54.dita" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
71 |
><apiname>TPointerEvent</apiname></xref> information from a single |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
72 |
pointer with no pressure and proximity data. The single pointer environment |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
73 |
rules describe the way in which pointer events coming from many pointers |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
74 |
in the multiple pointer model are transformed into events of one pointer. |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
75 |
They are necessary to ensure that old single-pointer applications |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
76 |
work in a multiple pointer environment intuitively and as expected |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
77 |
by the user. </p> <p>However, the new <codeph>TPointerEvent</codeph |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
78 |
> types, <xref href="GUID-239D0A8B-2759-321D-AD48-976E80192239.dita" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
79 |
><apiname>EEnterCloseProximity</apiname></xref>, <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
80 |
href="GUID-8C6264B4-5E19-33A7-92B0-BB79C871BEC7.dita"><apiname>EExitCloseProximity</apiname |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
81 |
></xref>, <xref href="GUID-F02DB96E-1541-3223-9B7B-79D45840DB7B.dita" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
82 |
><apiname>EEnterHighPressure</apiname></xref> and <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
83 |
href="GUID-15B5991C-B075-3110-B0A4-540EC282AA56.dita"><apiname>EExitHighPressure</apiname |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
84 |
></xref>, are delivered to all windows, even to those that do not |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
85 |
enable advanced pointers. </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
86 |
</ol> </section> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
87 |
<section id="GUID-C026DAB9-C11C-5D29-A1EA-6730E914250F"><title>Getting |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
88 |
Z coordinates from TPointerEvent</title> <ol |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
89 |
id="GUID-4CC2271D-1798-51B3-9A9D-E7E0B9A33DAE"> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
90 |
<li id="GUID-184B5B63-4EFC-55CD-8D1F-E015EEBACBE2"><p>Call <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
91 |
href="GUID-1FFA0073-3D83-388E-A824-08C31F90CC54.dita#GUID-1FFA0073-3D83-388E-A824-08C31F90CC54/GUID-E961DA4D-AD38-31F0-88DD-A07D36346DCB" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
92 |
><apiname>TPointerEvent::AdvancedPointerEvent()</apiname></xref> on |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
93 |
a <codeph>TPointerEvent</codeph> to return a pointer to a <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
94 |
href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita"><apiname>TAdvancedPointerEvent</apiname |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
95 |
></xref>. </p> <codeblock id="GUID-6E81680A-3070-546B-B575-49EA9E34FAF9" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
96 |
xml:space="preserve"> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
97 |
TZType aZType; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
98 |
TPointerEvent& aPointerEvent; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
99 |
TInt* aZ; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
100 |
TInt* aPoint3D; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
101 |
|
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
102 |
TAdvancedPointerEvent *advancedP = aPointerEvent.AdvancedPointerEvent(); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
103 |
</codeblock> <p> <codeph>TPointerEvent</codeph> is a struct that contains |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
104 |
details of a pointer event. <codeph>TZType</codeph> is a struct provided |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
105 |
by the programmer containing members to hold proximity, pressure, |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
106 |
and "proximity and pressure" data. </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
107 |
<li id="GUID-ABA8FA09-5F57-51BC-8CAE-43649B5ED6D3"><p>Now we need |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
108 |
to test whether the pointer event contains advanced pointer data. |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
109 |
If it is not an advanced pointer, the code leaves. </p> <p>If it is |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
110 |
an advanced pointer, we call functions to detect proximity, pressure, |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
111 |
"proximity and pressure" data and coordinates. </p> <codeblock |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
112 |
id="GUID-DF109643-2564-51A0-B0F6-33BF4DA1F6E3" xml:space="preserve" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
113 |
> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
114 |
if(!advancedP) |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
115 |
{ |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
116 |
// The TPointerEvent isn't an instance of TAdvancedPointerEvent |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
117 |
User::Leave(KErrArgument); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
118 |
} |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
119 |
|
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
120 |
switch(aZType) |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
121 |
{ |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
122 |
case EZTypeProximity: |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
123 |
aZ = advancedP->Proximity(); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
124 |
aPoint3D = advancedP->Proximity3D(); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
125 |
break; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
126 |
case EZTypePressure: |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
127 |
aZ = advancedP->Pressure(); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
128 |
aPoint3D = advancedP->Pressure3D(); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
129 |
break; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
130 |
case EZTypeProximityAndPressure: |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
131 |
aZ = advancedP->ProximityAndPressure(); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
132 |
aPoint3D = advancedP->ProximityAndPressure3D(); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
133 |
break; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
134 |
default: |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
135 |
User::Leave(KErrArgument); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
136 |
break; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
137 |
} |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
138 |
</codeblock> <ul> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
139 |
<li id="GUID-40C01884-AC86-5882-935D-2EC2E27C9004"><p> <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
140 |
href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-0ED4B1CC-0655-3246-8645-AAC9E0C27298" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
141 |
><apiname>TAdvancedPointerEvent::Proximity()</apiname></xref> returns |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
142 |
the proximity. </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
143 |
<li id="GUID-16A9A86B-A837-5E43-BB3A-F5A04A7F4552"><p> <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
144 |
href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-15DEBFBF-7B7D-3FCF-9929-C973824A5FD3" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
145 |
><apiname>TAdvancedPointerEvent::Pressure()</apiname></xref> returns |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
146 |
the pressure. </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
147 |
<li id="GUID-3E614890-C317-596E-A5B9-FD76426DBD12"><p> <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
148 |
href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-114AE77E-D0BD-321E-BFCB-1388B35582EC" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
149 |
><apiname>TAdvancedPointerEvent::ProximityAndPressure()</apiname></xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
150 |
> returns the proximity and pressure combined. </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
151 |
<li id="GUID-6F62C0D1-FAE4-5F8F-B451-68ABA404A369"><p> <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
152 |
href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-E5AA7737-D217-3FDE-9E4D-AAA7F5D2C300" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
153 |
><apiname>TAdvancedPointerEvent:: Position3D()</apiname></xref> returns |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
154 |
the proximity and the X, Y and Z coordinates. </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
155 |
<li id="GUID-5AD1811D-BCBF-5A44-B6E7-EB71BF254BCA"><p> <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
156 |
href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-2F30A8F5-75BA-3FE3-84B7-3C772ED75857" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
157 |
><apiname>TAdvancedPointerEvent::Pressure3D()</apiname></xref> returns |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
158 |
the pressure and the X and Y coordinates. </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
159 |
</ul> <p>Proximity is <i>always</i> negative and pressure is <i>always</i |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
160 |
> positive. Internally they are combined together as a Z coordinate. |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
161 |
When Z > 0, the proximity is 0 and the Z value represents the pressure. |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
162 |
When Z < 0, the pressure is 0 and the Z value represents the proximity. |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
163 |
Some APIs use only a Z coordinate (such as the threshold getters and |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
164 |
setters and <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
165 |
href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-114AE77E-D0BD-321E-BFCB-1388B35582EC" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
166 |
><apiname>TAdvancedPointerEvent::ProximityAndPressure()</apiname></xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
167 |
>). In these, the Z coordinate is interpreted in terms of pressure |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
168 |
and proximity. </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
169 |
</ol> <fig id="GUID-7A49B143-5458-5916-B937-55D98B77BB2C"> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
170 |
<title> Relationships between the pointer proximity, pressure and |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
171 |
Z coordinate </title> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
172 |
<image |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
173 |
href="GUID-1A0FB98B-8DB3-5067-9B71-FF838F6AE402_d0e241047_href.png" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
174 |
placement="inline"></image></fig> </section> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
175 |
<section id="GUID-B7057F69-191F-5AA4-8C61-EBECE66D92F6"><title>Pinch |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
176 |
zooming</title> <p>This example shows an easy way to pinch zoom an |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
177 |
image when the screen receives pointer events from two pointers. There |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
178 |
are two functions in this code that must be implemented by the programmer: <codeph |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
179 |
>BitmapCoordinates()</codeph> and <codeph>MoveBitmap()</codeph>. They |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
180 |
are not included in the example because they involve complex calculations |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
181 |
that are not related to advanced pointers. </p> <p>The high-level |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
182 |
steps to perform pinch zooming are: </p> <ol |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
183 |
id="GUID-AEF3917C-AAFE-5C25-9609-396D08478AC0"> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
184 |
<li id="GUID-7839E665-C4E1-59C8-BA89-22A62615EFA3"><p>Define the coordinates, |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
185 |
equivalent to the given on-screen coordinates. In the code example, |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
186 |
this is done using the function <codeph>BitmapCoordinates()</codeph |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
187 |
>. </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
188 |
<li id="GUID-FC4B1BDA-8120-53C9-9C88-BEFEF1AD54B4"><p>Define the ID |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
189 |
of the pointer by using <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
190 |
href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-67593D7E-CE40-303F-B847-81D6FC0578B1" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
191 |
><apiname>TAdvancedPointerEvent::PointerNumber()</apiname></xref>. |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
192 |
If the device can handle two pointers (two fingers) at the same time, |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
193 |
their numbers are 0 and 1. The pointer number enables you to distinguish |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
194 |
a given pointer from other pointers. </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
195 |
<li id="GUID-1E8F7D23-EEAD-5EA5-8863-276076D6B54E"><p>For each pointer |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
196 |
assign its coordinates to a local variable. We assume there are only |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
197 |
two pointers handled by the system here. </p> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
198 |
<li id="GUID-E44B3D9B-560A-5959-996D-A63CBD4C3786"><p>Use the <codeph |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
199 |
>MoveBitmap()</codeph> function to achieve the zoom effect. </p> <codeblock |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
200 |
id="GUID-D85CCFDD-8F65-530A-ACD7-93DD1D435FC6" xml:space="preserve" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
201 |
> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
202 |
/** |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
203 |
Receives pointer events from two pointers to perform Pinch Zoom of the image. |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
204 |
Function will finish when EButton1Up is received for any of the pointers. |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
205 |
@param aPointer1 Coordinates of pointer number 1 when zoom is started |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
206 |
@param aPointer2 Coordinates of pointer number 2 when zoom is started |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
207 |
*/ |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
208 |
|
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
209 |
void PinchZoom(TPoint aPointer1, TPoint aPointer2) |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
210 |
{ |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
211 |
TPoint actualP1 = aPointer1; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
212 |
TPoint actualP2 = aPointer2; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
213 |
|
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
214 |
// translate on-screen pointer coordinates to coordinates of displayed bitmap |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
215 |
TPoint bitmapCatching1 = BitmapCoordinates(aPointer1); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
216 |
TPoint bitmapCatching2 = BitmapCoordinates(aPointer2); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
217 |
|
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
218 |
TBool repaint = EFalse; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
219 |
|
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
220 |
while (ETrue) |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
221 |
{ |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
222 |
TAdvancedPointerEvent event = GetNextPointerEvent(); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
223 |
|
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
224 |
if (event.iType == TPointerEvent::EDrag) |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
225 |
{ |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
226 |
if (event.PointerNumber() == 1) |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
227 |
{ |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
228 |
actualP1 = event.iPosition; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
229 |
repaint = ETrue; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
230 |
} |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
231 |
else if (event.PointerNumber() == 2) |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
232 |
{ |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
233 |
actualP2 = event.iPosition; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
234 |
repaint = ETrue; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
235 |
} |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
236 |
} |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
237 |
else if (event.iType == TPointerEvent::EButton1Up) |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
238 |
{ |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
239 |
break; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
240 |
} |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
241 |
|
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
242 |
if (repaint) |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
243 |
{ |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
244 |
// move bitmap on the screen in the way that |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
245 |
// bitmapCatching1 point of the bitmap will be displayed at actualP1 screen coordinate, |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
246 |
// bitmapCatching2 point of the bitmap will be displayed at actualP2 screen coordinate. |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
247 |
MoveBitmap(bitmapCatching1, actualP1, bitmapCatching2, actualP2); |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
248 |
repaint = EFalse; |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
249 |
} |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
250 |
} |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
251 |
} |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
252 |
</codeblock> </li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
253 |
</ol> </section> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
254 |
</conbody> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
255 |
<related-links> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
256 |
<link href="GUID-9C269F45-F160-5A4B-ABF8-896D2A538E3B.dita"><linktext |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
257 |
>Advanced Pointer Overview</linktext></link> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
258 |
<link href="GUID-9AD75103-CD56-5279-B639-5CA2BBF979B5.dita"><linktext |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
259 |
>Advanced Pointer States and Event Communication</linktext> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
260 |
</link> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
261 |
</related-links> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
262 |
</concept> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
263 |
<?Pub *0000013536?> |