7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> |
9 --> |
10 <!DOCTYPE task |
10 <!DOCTYPE task |
11 PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd"> |
12 <task id="GUID-165EE4DD-C9CA-430B-8377-068A4194716E" xml:lang="en"><title>Modifying |
12 <task id="GUID-165EE4DD-C9CA-430B-8377-068A4194716E" xml:lang="en"><title>Modifying applications to support single-tap</title><shortdesc> Symbian^3 enhances the touch interaction by providing |
13 applications to support single-tap</title><shortdesc> Symbian^3 enhances the touch interaction by providing support |
13 support for single-tap.</shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> |
14 for single-tap.</shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> |
14 <context id="GUID-0EFB67F7-2936-4126-B13A-67402F696663"><p>S60 5th |
15 <context id="GUID-0EFB67F7-2936-4126-B13A-67402F696663"><p>S60 5th Edition |
15 Edition introduced touch support feature with double-tap to maintain |
16 introduced touch support feature with double-tap to maintain binary and source |
16 binary and source code compatibility with the existing S60 3.x applications. |
17 code compatibility with the existing S60 3.x applications. The UI was focus |
17 The UI was focus driven, with the first tap for object selection (the |
18 driven, with the first tap for object selection (the corresponding event forwarded |
18 corresponding event forwarded to the application) and the second tap |
19 to the application) and the second tap for activation.</p><p>Symbian^3 enhances |
19 for activation.</p><p>Symbian^3 enhances the touch support with single |
20 the touch support with single tap for achieving better usability and development |
20 tap for achieving better usability and development of platform and |
21 of platform and 3rd party applications. The supporting UI is based on direct |
21 3rd party applications. The supporting UI is based on direct manipulation |
22 manipulation and is not focus driven, which means that a single-tap on the |
22 and is not focus driven, which means that a single-tap on the device |
23 device selects and activates an event. This change modifies the touch behavior |
23 selects and activates an event. This change modifies the touch behavior |
24 of certain UI components as listed below:<ul> |
24 of certain UI components as listed below:<ul> |
25 <li><p>By default, none of the menu items are highlighted.</p></li> |
25 <li><p>By default, none of the menu items are highlighted.</p></li> |
26 <li><p>Item specific options are displayed in stylus menus rather than in |
26 <li><p>Item specific options are displayed in stylus menus rather |
27 options menus.</p></li> |
27 than in options menus.</p></li> |
28 <li><p>The side toolbar is hidden in the landscape layout view except in specific |
28 <li><p>The side toolbar is hidden in the landscape layout view except |
29 applications like the message viewer and editor.</p></li> |
29 in specific applications like the message viewer and editor.</p></li> |
30 </ul></p><p>It is highly recommended that you migrate your applications to |
30 </ul></p><p>It is highly recommended that you migrate your applications |
31 single-tap to complement the platform UI behavior. However, if you do not |
31 to single-tap to complement the platform UI behavior. However, if |
32 migrate your applications to single-tap, they work the same way as in S60 |
32 you do not migrate your applications to single-tap, they work the |
33 5th Edition (touch support with double-tap).<note> The UI components can be |
33 same way as in S60 5th Edition (touch support with double-tap). </p></context> |
34 used in hybrid devices for both touch and non-touch events. For details, see <xref href="GUID-EE001282-604B-45F4-8A9E-F657113C86CE.dita">Designing application UIs |
34 <steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-6-1-1-4-1-3-2"> |
35 for touch and non-touch devices</xref>.</note> </p></context> |
35 <step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-6-1-1-4-1-3-2-1"><cmd>Include |
36 <steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-4-1-1-7-1-4-1-3-2"> |
36 the <xref href="GUID-2A5F78CD-F404-338E-A505-93DC30CD4A0A.dita"><apiname>EAknTouchCompatible</apiname></xref> and <xref href="GUID-42FC6075-C1A0-3E68-8109-F6CC04CFBAE2.dita"><apiname>EAknSingleClickCompatible</apiname></xref> flags in your application's UI (<codeph>CAknAppUi</codeph> ) constructor.</cmd> |
37 <step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-4-1-1-7-1-4-1-3-2-1"><cmd>Include the <xref href="GUID-2A5F78CD-F404-338E-A505-93DC30CD4A0A.dita"><apiname>EAknTouchCompatible</apiname></xref> and <xref href="GUID-42FC6075-C1A0-3E68-8109-F6CC04CFBAE2.dita"><apiname>EAknSingleClickCompatible</apiname></xref> flags in your application's UI (<codeph>CAknAppUi</codeph> ) constructor.</cmd> |
|
38 <stepxmp><p>For example, </p><codeblock xml:space="preserve">void CFileBrowseBaseView::ConstructL() //Called from framework (CEikDocument) |
37 <stepxmp><p>For example, </p><codeblock xml:space="preserve">void CFileBrowseBaseView::ConstructL() //Called from framework (CEikDocument) |
39 { |
38 { |
40 ... |
39 ... |
41 BaseConstructL(EAknEnableSkin | EAknEnableMSK | <b>EAknTouchCompatible</b> | <b>EAknSingleClickCompatible</b>); |
40 BaseConstructL(EAknEnableSkin | EAknEnableMSK | <b>EAknTouchCompatible</b> | <b>EAknSingleClickCompatible</b>); |
42 ... |
41 ... |
43 }</codeblock></stepxmp> |
42 }</codeblock></stepxmp> |
44 <info><p>The <xref href="GUID-2A5F78CD-F404-338E-A505-93DC30CD4A0A.dita"><apiname>EAknTouchCompatible</apiname></xref> flag enables touch functionality. |
43 <info><p>The <xref href="GUID-2A5F78CD-F404-338E-A505-93DC30CD4A0A.dita"><apiname>EAknTouchCompatible</apiname></xref> flag enables touch |
45 The <xref href="GUID-42FC6075-C1A0-3E68-8109-F6CC04CFBAE2.dita"><apiname>EAknSingleClickCompatible</apiname></xref> flag enables single-click |
44 functionality. The <xref href="GUID-42FC6075-C1A0-3E68-8109-F6CC04CFBAE2.dita"><apiname>EAknSingleClickCompatible</apiname></xref> flag |
46 functionality on the Symbian device.</p></info> |
45 enables single-click functionality on the Symbian device.</p></info> |
47 <stepresult><p>The following illustrations show how applications behave before |
46 <stepresult><p>The following illustrations show how applications behave |
48 and after the single-tap changes are made:</p><fig id="GUID-7015C5AD-8162-4185-801C-BEF4352B9837"> |
47 before and after the single-tap changes are made:</p><fig id="GUID-7015C5AD-8162-4185-801C-BEF4352B9837"> |
49 <title>Double-tap enabled: By default, UI component is highlighted.</title> |
48 <title>Double-tap enabled: By default, UI component is highlighted.</title> |
50 <image href="GUID-BF626AFA-F8E5-4049-BC3E-E947AD2D39A1_d0e2580_href.png" placement="inline"/> |
49 <image href="GUID-BF626AFA-F8E5-4049-BC3E-E947AD2D39A1_d0e2684_href.png" placement="inline"/> |
51 </fig><fig id="GUID-12C4AB22-ACF7-4A43-B322-ABB39B5653DC"> |
50 </fig><fig id="GUID-12C4AB22-ACF7-4A43-B322-ABB39B5653DC"> |
52 <title>Single-tap enabled: By default, no UI component is highlighted.</title> |
51 <title>Single-tap enabled: By default, no UI component is highlighted.</title> |
53 <image href="GUID-CAB2A21A-B2EE-4B49-AC97-7F70BDC95755_d0e2587_href.png" placement="inline"/> |
52 <image href="GUID-CAB2A21A-B2EE-4B49-AC97-7F70BDC95755_d0e2691_href.png" placement="inline"/> |
54 </fig></stepresult> |
53 </fig></stepresult> |
55 </step> |
54 </step> |
56 <step id="GUID-CCF099FE-76F5-49AC-99A7-E834A07FD628"><cmd>Hide item-specific |
55 <step id="GUID-CCF099FE-76F5-49AC-99A7-E834A07FD628"><cmd>Hide item-specific |
57 commands from the application's <xref href="GUID-AC8439C7-7E57-4829-AB4B-70BC394DD66F.dita">menus</xref>, <xref href="GUID-244631CF-03F9-4C48-9802-682A76E9ECCC.dita">submenus</xref> and <xref href="GUID-E3A60844-EE37-4AF1-8921-59375C563723.dita">toolbars</xref>. Item-specific |
56 commands from the application's <xref href="GUID-AC8439C7-7E57-4829-AB4B-70BC394DD66F.dita">menus</xref>, <xref href="GUID-244631CF-03F9-4C48-9802-682A76E9ECCC.dita">submenus</xref> and <xref href="GUID-E3A60844-EE37-4AF1-8921-59375C563723.dita">toolbars</xref>. |
58 commands are functions that are specific to an item. For example, <b>Edit</b> is |
57 Item-specific commands are functions that are specific to an item. |
59 an item-specific command for an existing contact in the <b>Phone book</b>.</cmd> |
58 For example, <b>Edit</b> is an item-specific command for an existing |
60 <stepresult><p>As a result, all item-specific options are hidden in menus, |
59 contact in the <b>Phone book</b>.</cmd> |
61 submenus and toolbars and are displayed in the <xref href="GUID-C4E728B4-3E84-49A4-83CB-DF146420D78A.dita">stylus |
60 <stepresult><p>As a result, all item-specific options are hidden in |
62 popup menus</xref>. </p></stepresult> |
61 menus, submenus and toolbars and are displayed in the <xref href="GUID-C4E728B4-3E84-49A4-83CB-DF146420D78A.dita">stylus popup menus</xref>. </p></stepresult> |
63 </step> |
62 </step> |
64 <step id="GUID-10C30123-1921-43E1-B39F-C41DC65991E6"><cmd><xref href="GUID-361BB951-DB74-4D83-ACFC-812383C8129C.dita">Activate |
63 <step id="GUID-10C30123-1921-43E1-B39F-C41DC65991E6"><cmd><xref href="GUID-361BB951-DB74-4D83-ACFC-812383C8129C.dita">Activate items in |
65 items in a list</xref> on single-tap.</cmd> |
64 a list</xref> on single-tap.</cmd> |
66 </step> |
65 </step> |
67 <step id="GUID-10F9F971-4E80-4D0A-90B2-7BDC9C40E0A9"><cmd><xref href="GUID-78453EBD-B4F3-4A78-AEAE-3D126DFED31F.dita">Disable |
66 <step id="GUID-10F9F971-4E80-4D0A-90B2-7BDC9C40E0A9"><cmd><xref href="GUID-78453EBD-B4F3-4A78-AEAE-3D126DFED31F.dita">Disable stylus popup |
68 stylus popup menu in AVKON lists</xref>.</cmd> |
67 menu in AVKON lists</xref>.</cmd> |
69 </step> |
68 </step> |
70 <step id="GUID-FF167282-56A6-42F4-ABAE-5A53ECCC0E2F"><cmd><xref href="GUID-2131E679-779D-427D-BD41-47D9949A8749.dita">Disable |
69 <step id="GUID-FF167282-56A6-42F4-ABAE-5A53ECCC0E2F"><cmd><xref href="GUID-2131E679-779D-427D-BD41-47D9949A8749.dita">Disable hardware |
71 hardware key shortcuts</xref>.</cmd> |
70 key shortcuts</xref>.</cmd> |
72 </step> |
71 </step> |
73 </steps> |
72 </steps> |
74 </taskbody></task> |
73 </taskbody></task> |