|
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-0C19D3F1-CF60-4760-8A77-242E14647738" xml:lang="en"><title>Touch |
|
13 UI observer interfaces</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>To support the touch functionality in existing UI components too, S60 5th |
|
15 Edition introduced new observer interfaces to the existing components. These |
|
16 are:</p> |
|
17 <ul> |
|
18 <li><p><i>Navigation decorator observer</i></p><p>The navigation decorator |
|
19 observer interface is used in the navigation pane. The interface receives |
|
20 an event indicating that the decorator’s right or left arrow has been tapped |
|
21 (or the navi label), and then the observer implementation can perform an action |
|
22 (for example, raise the volume or change focus to the next tab). This might |
|
23 be useful if you implement custom controls to be included in the navigation |
|
24 control.</p><p>It is defined by <codeph>MAknNaviDecoratorObserver</codeph>. |
|
25 The observer can be set by <codeph>CAknNavigationDecorator::SetNaviDecoratorObserver</codeph>.</p> </li> |
|
26 <li><p><i>Long tap detector</i></p><p>The long tap detector (<codeph>CAknLongTapDetector</codeph>) |
|
27 is an Avkon component that an application or control can use to receive long |
|
28 tap events.</p><p>The long tap handler must inherit from <codeph>MAknLongTapDetectorCallBack</codeph> and |
|
29 implement the <codeph>HandleLongTapEventL</codeph> call back function for |
|
30 long tap events.</p> <p>When the stylus is held down in the same position, |
|
31 an animation starts in about 0.15 s to show that the long tap functionality |
|
32 has started. Animation is provided by AVKON and cannot be changed by the application |
|
33 or control. However, animation can be turned off using the class <codeph>CAknLongTapDetector</codeph> in |
|
34 the Touch UI utilities API.</p> <p>For implementation infomation, see the <xref href="GUID-92018B6B-3CBB-434D-9E61-F271C67E98E3.dita">Touch UI utilities API specification</xref>.</p></li> |
|
35 <li><p><i>Double-click support in lists</i></p><p>In order to receive double-click |
|
36 events from a list or grid, the object that wishes to be informed must implement |
|
37 and register the <codeph>MEikListBoxObserver</codeph> interface via <codeph>CEikListBox::SetListBoxObserver</codeph>. </p></li> |
|
38 <li><p><i>Title pane touch observer</i></p><p>The title pane touch observer |
|
39 enables you to provide functionality for title pane touch events. For implementation |
|
40 information, see the <xref href="GUID-B876D548-FD40-4369-B328-7427002B4851.dita">Title |
|
41 pane touch observer API specification</xref>.</p></li> |
|
42 </ul> |
|
43 </conbody></concept> |