|
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 --> <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-8B137691-7C9E-4085-BFFE-4CFE4A64A091" xml:lang="en"><title>Control |
|
10 pane</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody> |
|
11 <p>The Control pane occupies the bottom part of the screen and |
|
12 displays the labels associated with the softkeys.</p> |
|
13 <fig id="GUID-04E1523C-BC5C-4951-83FD-FD48B8370B6E"> |
|
14 <title>Control pane</title> |
|
15 <image href="GUID-4DEC6706-6189-4E91-AEA9-479DDF04B955_d0e53591_href.png" scale="40" placement="inline"></image> |
|
16 </fig> |
|
17 <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>, |
|
19 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> |
|
21 <p>The actual physical softkeys should be positioned directly beneath the |
|
22 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 |
|
24 (see <xref href="GUID-2F264A2A-FA7A-4718-A6B6-9A764C1D1E0E.dita">Labeling the Selection |
|
25 key</xref> for further details).</p> |
|
26 <section><title>Using the control pane |
|
27 in C++ applications</title><p>The APIs to use for the control pane are the Buttons |
|
28 API for the softkeys and the Options |
|
29 menu API for the menus.</p><p>For implementation information on using |
|
30 the softkeys, see Using |
|
31 the Buttons API. For implementation information on the menus, see Using |
|
32 the Options menu API.</p><p>The Symbian platform uses Control Button |
|
33 Area (CBA) resources to set the options in the control pane above the softkeys. |
|
34 CBA resources map the text that appears above the softkeys in the control |
|
35 pane with commands that are collected by the event loop of the application |
|
36 framework and delivered to your application for <xref href="GUID-4941C035-C359-4968-9BD5-31F44EE5F810.dita">command |
|
37 handling</xref>.</p><p>When a mobile device user selects an Options softkey, |
|
38 the application framework displays the Options menu based upon the definitions |
|
39 in the menu bar's resources.</p><p>The Symbian platform uses MENU_BAR resources |
|
40 to create the Options menu, when a mobile device user selects the Options |
|
41 softkey. The options that appear above the softkeys are determined by CBA |
|
42 resources. The MENU_BAR resources map the text that appears in the Options |
|
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> |