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_d0e78566_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>