<?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-A4F3738C-CBFD-4151-9132-26FE05966715" xml:lang="en"><title>CBA buttons</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<fig id="GUID-A84D5799-70F3-46CB-90B6-05A455B0499E"><title>Application with Options and Exit softkeys in portrait
and landscape views</title><image href="GUID-A69D2707-CB47-42C2-A6E9-5FB9BD86A30B_d0e67789_href.png"/></fig>
<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>
<note>
<ul>
<li><p>The left softkey and right softkey are placed inside the
CBA.</p></li>
<li><p>You must disable item-specific softkeys.</p></li>
<li><p>If there is no highlight then, the left softkey is hidden.</p>
</li>
</ul>
</note>
<p>When a mobile device user selects an <parmname>Options</parmname> softkey,
the application framework displays the <parmname>Options</parmname> menu based
upon the definitions in the <xref href="GUID-5918ED8A-B26B-41A0-94A6-AB6D51BF80A1.dita">menu
bars</xref> resources.</p>
<p>Depending upon the requirements of your application, you can either:</p>
<ul>
<li><p><xref href="GUID-A3AF142B-F9DF-43FD-9D3F-788A74D0C575.dita">use
precompiled CBA button options contained in <parmname>avkon.hrh</parmname></xref></p>
</li>
<li><p><xref href="GUID-5B26AB8E-E20A-4C15-B4F8-812ED9A4A96C.dita">create
your own buttons</xref></p></li>
</ul>
<p>CBA buttons are constructed using the <xref format="html" href="specs/guides/Buttons_API_Specification/Buttons_API_Specification.html" scope="external">Buttons
API</xref>.</p>
</conbody></concept>