<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-8B137691-7C9E-4085-BFFE-4CFE4A64A091" xml:lang="en"><title>Control

pane</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>The Control pane occupies the bottom part of the screen and displays the

labels associated with the softkeys. </p>

<fig id="GUID-3B64A270-FF5A-4F7E-9D8E-903846944485">

<title>Control pane</title>

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

</fig>

<p>Normal touch down and release functionality applies to the softkeys in

control pane. Activation is performed on touch release. However, activation

can be cancelled by dragging the touch from the softkey area and performing

a touch release.</p>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

</conbody></concept>