2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
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 |
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, |
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". --> |
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
6 <!-- Initial Contributors: |
6 <!-- Initial Contributors: |
7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-92018B6B-3CBB-434D-9E61-F271C67E98E3" xml:lang="en"><title>Touch |
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-92018B6B-3CBB-434D-9E61-F271C67E98E3" xml:lang="en"><title>Touch |
10 UI utilities API</title><shortdesc>The Touch UI utilities API is used for detecting long-tap events |
13 UI utilities API</title><shortdesc>The Touch UI utilities API is used for detecting long-tap events |
11 and showing an animation for them. </shortdesc><prolog><metadata><keywords></keywords></metadata></prolog><conbody> |
14 and showing an animation for them. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
12 <p>A long tap, also called a touch down and hold event, means that the user |
15 <p>A long tap, also called a touch down and hold event, means that the user |
13 holds the stylus down on the screen at the same point for a long time.</p> |
16 holds the stylus down on the screen at the same point for a long time.</p> |
14 <fig id="GUID-1E6C16F9-51AA-45CC-8E50-AB5E51DB9E4E"> |
17 <fig id="GUID-1E6C16F9-51AA-45CC-8E50-AB5E51DB9E4E"> |
15 <title>Long-tap event used for opening a stylus pop-up menu</title> |
18 <title>Long-tap event used for opening a stylus pop-up menu</title> |
16 <image href="GUID-78989363-A405-4A1D-8F13-DC52FE6FAD80_d0e75590_href.png" scale="40" placement="inline"></image> |
19 <image href="GUID-78989363-A405-4A1D-8F13-DC52FE6FAD80_d0e108366_href.png" scale="40" placement="inline"/> |
17 </fig> |
20 </fig> |
18 <p>The Touch UI utilities API can be used in all GUI applications. It is a |
21 <p>The Touch UI utilities API can be used in all GUI applications. It is a |
19 library API that provides an interface for constructing and using the long-tap |
22 library API that provides an interface for constructing and using the long-tap |
20 detector component.</p> |
23 detector component.</p> |
21 <p>For user experience guidelines on the long-tap component, see <xref href="GUID-C11AF871-56C8-4EA4-A1E0-E2B23372EF84.dita">Touch |
24 <p>For user experience guidelines on the long-tap component, see <xref href="GUID-C11AF871-56C8-4EA4-A1E0-E2B23372EF84.dita">Touch |
22 down and hold</xref>.</p> |
25 down and hold</xref>.</p> |
23 <p>For the Touch UI utilities API classes and header files, see Classes and Definitions.</p> |
26 <p>For the Touch UI utilities API classes and header files, see Classes and |
|
27 Definitions.</p> |
24 <p>For implementation information, see <xref href="GUID-A15EDC87-A6EF-40D8-AA78-B52449465FEA.dita">Receiving |
28 <p>For implementation information, see <xref href="GUID-A15EDC87-A6EF-40D8-AA78-B52449465FEA.dita">Receiving |
25 long tap events</xref>.</p> |
29 long tap events</xref>.</p> |
26 <section id="GUID-139D3102-1273-4F4D-9239-309677968281"><title>Error handling</title><p>The |
30 <section id="GUID-139D3102-1273-4F4D-9239-309677968281"><title>Error handling</title><p>The |
27 leave mechanism of the Symbian OS environment is used for handling memory |
31 leave mechanism of the Symbian platform environment is used for handling memory |
28 exhaustion.</p></section> |
32 exhaustion.</p></section> |
29 <section id="GUID-A4320820-D2A9-44C1-B2F0-C47A8C6CED6B"><title>Constraints</title><p>This |
33 <section id="GUID-A4320820-D2A9-44C1-B2F0-C47A8C6CED6B"><title>Constraints</title><p>This |
30 API is valid for all touch enabled Symbian platforms.</p></section> |
34 API is valid for all touch enabled Symbian platforms.</p></section> |
31 <section id="GUID-C1463788-923F-4AF2-884B-3B16C93E7536"><title>Emulator support</title><p>This |
35 <section id="GUID-C1463788-923F-4AF2-884B-3B16C93E7536"><title>Emulator support</title><p>This |
32 API is fully supported in the WINS/WINSCW emulator environment.</p></section> |
36 API is fully supported in the WINS/WINSCW emulator environment.</p></section> |