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-8B137691-7C9E-4085-BFFE-4CFE4A64A091" xml:lang="en"><title>Control

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

    17 <title>Control pane</title>

    18 <image href="GUID-A0208BE3-127F-4D04-8045-09C54EF202DD_d0e72845_href.png" placement="inline"/>

    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>

    24 <p>The Control pane is also active during <xref href="GUID-BFEEECCA-190B-4DDE-8A04-4FE918BE8690.dita">Options

    25 menus</xref>, <xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">queries</xref>,

    26 and other states using <xref href="GUID-2922758C-37A4-436E-B0F3-358944F84E2A.dita">pop-up

    27 windows</xref>, although it does not itself reside in a pop-up window.</p>

    28 <p>The actual physical softkeys should be positioned directly beneath the

    29 screen so that the association between the keys and their respective labels

    30 is evident. Note, however, that the middle label refers to the Selection key

    31 (see <xref href="GUID-2F264A2A-FA7A-4718-A6B6-9A764C1D1E0E.dita">Labeling the Selection

    32 key</xref> for further details).</p>

    33 <section id="GUID-E372B9B2-8E4A-4D39-8857-CC0A66F9BC75"><title>Using

    34 the control pane in C++ applications</title><p>The APIs to use for the control

    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

    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

    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

    38 platform uses Control Button Area (CBA) resources to set the options in the

    39 control pane above the softkeys. CBA resources map the text that appears above

    40 the softkeys in the control pane with commands that are collected by the event

    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

    42 a mobile device user selects an Options softkey, the application framework

    43 displays the Options menu based upon the definitions in the menu bar's resources.</p><p>The

    44 Symbian platform uses MENU_BAR resources to create the Options menu, when

    45 a mobile device user selects the Options softkey. The options that appear

    46 above the softkeys are determined by CBA resources. The MENU_BAR resources

    47 map the text that appears in the Options menu with commands that are collected

    48 by the event loop of the application framework and delivered to your application

    49 for command handling. </p></section>

    50 </conbody></concept>