Symbian3/PDK/Source/GUID-17C64C2F-9426-4B41-9F0A-23060289D644.dita
changeset 11 5072524fcc79
parent 9 59758314f811
child 12 80ef3a206772
equal deleted inserted replaced
10:d4524d6a4472 11:5072524fcc79
     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-17C64C2F-9426-4B41-9F0A-23060289D644" xml:lang="en">
     6 <!-- Initial Contributors:
     6 <title>Mu<?Pub Caret?>ltiple touch</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>Multiple touch is an enhancement to the touch screen, which provides
    12 <concept id="GUID-17C64C2F-9426-4B41-9F0A-23060289D644" xml:lang="en"><title>Multi-touch</title><prolog><metadata><keywords/></metadata></prolog><conbody>
       
    13 <p>Multi-touch is an enhancement to the touch screen, which provides
       
    14 the user with the ability to apply elaborate finger gestures onto
    12 the user with the ability to apply elaborate finger gestures onto
    15 the display as commands to the device.</p>
    13 the display as commands to the device.</p>
    16 <p>Multi-touch is implemented based on the size and type of interfaces.
    14 <p>Multiple touch is implemented based on the size and type of interfaces.
    17 When a finger or an object touches the display causing the light to
    15 When a finger or an object touches the display causing the light to
    18 scatter, the reflection is caught by the sensors. The response for
    16 scatter, the reflection is caught by the sensors. The response for
    19 the touch is sent back based on the type of reflection measured.</p>
    17 the touch is sent back based on the type of reflection measured.</p>
    20 <p>Only the devices with multi-touch support have 'Pinch Stroke' as
    18 <p>Only the devices with multiple touch support have 'Pinch Stroke'
    21 a touch stroke.</p>
    19 as a touch stroke.</p>
    22 <section id="GUID-7AECBBDD-8583-4555-A2F3-83404CBC64C1"><title>Pinch
    20 <section id="GUID-7AECBBDD-8583-4555-A2F3-83404CBC64C1"><title>Pinch
    23 Stroke</title>Pinch stroke is invoked by two separate but simultaneously
    21 Stroke</title>Pinch stroke is invoked by two separate but simultaneously
    24 active touch down events and dragging movements along the line that
    22 active touch down events and dragging movements along the line that
    25 goes through both touch down points. On release, the pinch in or pinch
    23 goes through both touch down points. On release, the pinch in or pinch
    26 out state is maintained. Pinch stroke can be utilized, for example,
    24 out state is maintained. Pinch stroke can be utilized, for example,
    27 in Photo viewer to zoom in and zoom out.<fig id="GUID-93C93C51-1F0D-4ADE-8FEC-3223B9C9F60B">
    25 in Photo viewer to zoom in and zoom out.<fig
    28 <image href="GUID-22498580-E902-4024-921C-F756A8CD58DF_d0e98725_href.png" placement="inline"/>
    26 id="GUID-93C93C51-1F0D-4ADE-8FEC-3223B9C9F60B"><image
    29 </fig><p>The following table lists the default touch-events for pinch-stroke:</p><table id="GUID-D5917E40-42B1-461B-8722-C7AD66482078-GENID-1-12-1-7-1-1-6-2-1-5-1-1-6-1-2-4-4"><title>Default
    27 href="GUID-22498580-E902-4024-921C-F756A8CD58DF_d0e98725_href.png"
    30 touch events for pinch-stroke</title>
    28 placement="inline"></image></fig><p>The following table lists the
    31 <tgroup cols="3"><colspec colname="col1" colwidth="0.68*"/><colspec colname="col2" colwidth="1.00*"/><colspec colname="col3" colwidth="1.32*"/>
    29 default touch-events for pinch-stroke:</p><table
       
    30 id="GUID-D5917E40-42B1-461B-8722-C7AD66482078-GENID-1-12-1-7-1-1-6-2-1-5-1-1-6-1-2-4-4">
       
    31 <title>Default touch events for pinch-stroke</title>
       
    32 <tgroup cols="3"><colspec colname="col1" colwidth="0.68*"/><colspec
       
    33 colname="col2" colwidth="1.00*"/><colspec colname="col3" colwidth="1.32*"/>
    32 <thead>
    34 <thead>
    33 <row>
    35 <row>
    34 <entry valign="top"><p>User action</p></entry>
    36 <entry valign="top"><p>User action</p></entry>
    35 <entry valign="top"><p>State change</p></entry>
    37 <entry valign="top"><p>State change</p></entry>
    36 <entry valign="top"><p>Feedback</p></entry>
    38 <entry valign="top"><p>Feedback</p></entry>
    46 <li><p>Audio feedback is provided with touch down.</p></li>
    48 <li><p>Audio feedback is provided with touch down.</p></li>
    47 </ul></p></entry>
    49 </ul></p></entry>
    48 </row>
    50 </row>
    49 <row>
    51 <row>
    50 <entry><p>Second simultaneous touch down</p></entry>
    52 <entry><p>Second simultaneous touch down</p></entry>
    51 <entry><p>Activates multi-touch mode for the content defined.</p></entry>
    53 <entry><p>Activates multiple touch mode for the content defined.</p
       
    54 ></entry>
    52 <entry><p>Tactile: <ul>
    55 <entry><p>Tactile: <ul>
    53 <li><p>When second finger is touched down multi-touch recognition,
    56 <li><p>When second finger is touched down, two sensitive pulses effect
    54 two sensitive pulses effect is provided.</p></li>
    57 is provided.</p></li>
    55 <li><p>Audio feedback is provided with touch down.</p></li>
    58 <li><p>Audio feedback is provided with touch down.</p></li>
    56 </ul></p></entry>
    59 </ul></p></entry>
    57 </row>
    60 </row>
    58 <row>
    61 <row>
    59 <entry><p>Pinch in</p></entry>
    62 <entry><p>Pinch in</p></entry>
    79 <entry><p>No tactile or audio feedback given.</p></entry>
    82 <entry><p>No tactile or audio feedback given.</p></entry>
    80 </row>
    83 </row>
    81 </tbody>
    84 </tbody>
    82 </tgroup>
    85 </tgroup>
    83 </table></section>
    86 </table></section>
    84 <section id="GUID-C9D46D3B-B1D0-45C7-8A9F-FCF82653D78F"><title>Using multi-touch in applications</title>For multi-touch,
    87 <section id="GUID-C9D46D3B-B1D0-45C7-8A9F-FCF82653D78F"><title>Using
    85 use classes <xref href="GUID-668CEA36-3933-3BBE-A980-CAB62617B4FD.dita"><apiname>TRawEvent</apiname></xref> and <xref href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita"><apiname>TAdvancedPointerEvent</apiname></xref> (which extends <xref href="GUID-1FFA0073-3D83-388E-A824-08C31F90CC54.dita"><apiname>TPointerEvent</apiname></xref>). For more information,
    88 multiple touch in applications</title>For multiple touch, use classes <xref
    86 see <xref href="GUID-A12A66ED-2C8F-5CE6-8F3E-332B045A35B4.dita">Advanced
    89 href="GUID-668CEA36-3933-3BBE-A980-CAB62617B4FD.dita"><apiname>TRawEvent</apiname
    87 pointers</xref> section.</section>
    90 ></xref> and <xref href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita"
    88 </conbody></concept>
    91 ><apiname>TAdvancedPointerEvent</apiname></xref> (which extends <xref
       
    92 href="GUID-1FFA0073-3D83-388E-A824-08C31F90CC54.dita"><apiname>TPointerEvent</apiname
       
    93 ></xref>). For more information, see <xref
       
    94 href="GUID-A12A66ED-2C8F-5CE6-8F3E-332B045A35B4.dita">Advanced pointers</xref
       
    95 > section.</section>
       
    96 </conbody>
       
    97 </concept>
       
    98 <?Pub *0000004277?>