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-8B137691-7C9E-4085-BFFE-4CFE4A64A091" xml:lang="en"><title>Control |
9 --> |
10 pane</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody> |
10 <!DOCTYPE concept |
11 <p>The Control pane occupies the bottom part of the screen and |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 displays the labels associated with the softkeys.</p> |
12 <concept id="GUID-8B137691-7C9E-4085-BFFE-4CFE4A64A091" xml:lang="en"><title>Control |
13 <fig id="GUID-04E1523C-BC5C-4951-83FD-FD48B8370B6E"> |
13 pane</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>The Control pane occupies the bottom part of the screen and displays the |
|
15 labels associated with the softkeys. </p> |
|
16 <fig id="GUID-3B64A270-FF5A-4F7E-9D8E-903846944485"> |
14 <title>Control pane</title> |
17 <title>Control pane</title> |
15 <image href="GUID-4DEC6706-6189-4E91-AEA9-479DDF04B955_d0e78566_href.png" scale="40" placement="inline"></image> |
18 <image href="GUID-A0208BE3-127F-4D04-8045-09C54EF202DD_d0e100721_href.png" placement="inline"/> |
16 </fig> |
19 </fig> |
|
20 <p>Normal touch down and release functionality applies to the softkeys in |
|
21 control pane. Activation is performed on touch release. However, activation |
|
22 can be cancelled by dragging the touch from the softkey area and performing |
|
23 a touch release.</p> |
17 <p>The Control pane is also active during <xref href="GUID-BFEEECCA-190B-4DDE-8A04-4FE918BE8690.dita">Options |
24 <p>The Control pane is also active during <xref href="GUID-BFEEECCA-190B-4DDE-8A04-4FE918BE8690.dita">Options |
18 menus</xref>, <xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">queries</xref>, |
25 menus</xref>, <xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">queries</xref>, |
19 and other states using <xref href="GUID-2922758C-37A4-436E-B0F3-358944F84E2A.dita">pop-up |
26 and other states using <xref href="GUID-2922758C-37A4-436E-B0F3-358944F84E2A.dita">pop-up |
20 windows</xref>, although it does not itself reside in a pop-up window.</p> |
27 windows</xref>, although it does not itself reside in a pop-up window.</p> |
21 <p>The actual physical softkeys should be positioned directly beneath the |
28 <p>The actual physical softkeys should be positioned directly beneath the |
22 screen so that the association between the keys and their respective labels |
29 screen so that the association between the keys and their respective labels |
23 is evident. Note, however, that the middle label refers to the Selection key |
30 is evident. Note, however, that the middle label refers to the Selection key |
24 (see <xref href="GUID-2F264A2A-FA7A-4718-A6B6-9A764C1D1E0E.dita">Labeling the Selection |
31 (see <xref href="GUID-2F264A2A-FA7A-4718-A6B6-9A764C1D1E0E.dita">Labeling the Selection |
25 key</xref> for further details).</p> |
32 key</xref> for further details).</p> |
26 <section><title>Using the control pane |
33 <section id="GUID-E372B9B2-8E4A-4D39-8857-CC0A66F9BC75"><title>Using |
27 in C++ applications</title><p>The APIs to use for the control pane are the Buttons |
34 the control pane in C++ applications</title><p>The APIs to use for the control |
28 API for the softkeys and the Options |
35 pane are the <xref format="html" href="specs/guides/Buttons_API_Specification/Buttons_API_Specification.html" scope="peer">Buttons API</xref> for the softkeys and the <xref format="html" href="specs/guides/Options_Menu_API_Specification/Options_Menu_API_Specification.html" scope="peer">Options menu API</xref> for the menus.</p><p>For implementation |
29 menu API for the menus.</p><p>For implementation information on using |
36 information on using the softkeys, see <xref format="html" href="specs/guides/Buttons_API_Specification/Buttons_API_Specification.html#Buttons_API_Specification.topic3" scope="peer">Using the Buttons API</xref>. For implementation information |
30 the softkeys, see Using |
37 on the menus, see <xref format="html" href="specs/guides/Options_Menu_API_Specification/Options_Menu_API_Specification.html#Options_Menu_API_Specification.topic3" scope="peer">Using the Options menu API</xref>.</p><p>The Symbian |
31 the Buttons API. For implementation information on the menus, see Using |
38 platform uses Control Button Area (CBA) resources to set the options in the |
32 the Options menu API.</p><p>The Symbian platform uses Control Button |
39 control pane above the softkeys. CBA resources map the text that appears above |
33 Area (CBA) resources to set the options in the control pane above the softkeys. |
40 the softkeys in the control pane with commands that are collected by the event |
34 CBA resources map the text that appears above the softkeys in the control |
41 loop of the application framework and delivered to your application for <xref href="GUID-4941C035-C359-4968-9BD5-31F44EE5F810.dita">command handling</xref>.</p><p>When |
35 pane with commands that are collected by the event loop of the application |
42 a mobile device user selects an Options softkey, the application framework |
36 framework and delivered to your application for <xref href="GUID-4941C035-C359-4968-9BD5-31F44EE5F810.dita">command |
43 displays the Options menu based upon the definitions in the menu bar's resources.</p><p>The |
37 handling</xref>.</p><p>When a mobile device user selects an Options softkey, |
44 Symbian platform uses MENU_BAR resources to create the Options menu, when |
38 the application framework displays the Options menu based upon the definitions |
45 a mobile device user selects the Options softkey. The options that appear |
39 in the menu bar's resources.</p><p>The Symbian platform uses MENU_BAR resources |
46 above the softkeys are determined by CBA resources. The MENU_BAR resources |
40 to create the Options menu, when a mobile device user selects the Options |
47 map the text that appears in the Options menu with commands that are collected |
41 softkey. The options that appear above the softkeys are determined by CBA |
48 by the event loop of the application framework and delivered to your application |
42 resources. The MENU_BAR resources map the text that appears in the Options |
49 for command handling. </p></section> |
43 menu with commands that are collected by the event loop of the application |
|
44 framework and delivered to your application for command handling. </p></section> |
|
45 </conbody></concept> |
50 </conbody></concept> |