Nokia Corporation - initial contribution.

-->

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

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

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

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