|
1 <?xml version="1.0" encoding="utf-8"?> |
|
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 |
|
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". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-C11AF871-56C8-4EA4-A1E0-E2B23372EF84" xml:lang="en"><title>Touch |
|
13 down and hold</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>Touch down and hold is used, for example, to open the Symbian |
|
15 stylus pop-up menu. Applications can use an animation (starts after 0.15 seconds |
|
16 from the start of a stylus down event) to indicate that a Touch down and hold |
|
17 action has been initiated.</p> |
|
18 <p>On the whole, Touch down and hold may be difficult for users to find, and |
|
19 therefore its use should be considered carefully. As in the case of task swapping, |
|
20 the use of Touch down and hold should aim at being analogous to using a long |
|
21 key press on the hardware keys.</p> |
|
22 <section id="GUID-F3F82BBF-587D-471E-A2DE-E9248077EE0A"><title>Using |
|
23 touch down and hold events in C++ applications</title><p>The API to use for |
|
24 receiving touch down and hold events in applications or controls is the <xref href="GUID-92018B6B-3CBB-434D-9E61-F271C67E98E3.dita">Touch UI utilities API</xref>.</p><p>Use |
|
25 the class <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknLongTapDetector.html" format="application/java-archive"><codeph>CAknLogTapDetector</codeph></xref> to |
|
26 receive touch down and hold events, called long tap events in the API reference.</p><p>Your |
|
27 long tap handler must inherit from the class <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classMAknLongTapDetectorCallBack.html" format="application/java-archive"><codeph>MAknLongTapDetectorCallBack</codeph></xref> and implement the <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classMAknLongTapDetectorCallBack.html#fe6ac5bacc8f58579a53889d524e661f" format="application/java-archive"><codeph>MAknLongTapDetectorCallBack::HandleLongTapEventL()</codeph></xref> call |
|
28 back function.</p></section> |
|
29 </conbody></concept> |