--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-8B137691-7C9E-4085-BFFE-4CFE4A64A091.dita Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,50 @@
+<?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>
\ No newline at end of file