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-A4F3738C-CBFD-4151-9132-26FE05966715" xml:lang="en"><title>CBA buttons</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    13 <fig id="GUID-A84D5799-70F3-46CB-90B6-05A455B0499E"><title>Application with Options and Exit softkeys, portrait and landscape

    14 views</title><image href="GUID-A69D2707-CB47-42C2-A6E9-5FB9BD86A30B_d0e72940_href.png"/></fig>

    15 <p>The Symbian platform uses Control Button Area (CBA) resources to set

    16 the options in the control pane above the softkeys. CBA resources map the

    17 text that appears above the softkeys in the control pane with commands that

    18 are collected by the event loop of the application framework and delivered

    19 to your application for <xref href="GUID-4941C035-C359-4968-9BD5-31F44EE5F810.dita">command

    20 handling</xref>.</p>

    21 <p>When a mobile device user selects an <parmname>Options</parmname> softkey,

    22 the application framework displays the <parmname>Options</parmname> menu based

    23 upon the definitions in the <xref href="GUID-5918ED8A-B26B-41A0-94A6-AB6D51BF80A1.dita">menu

    24 bars</xref> resources.</p>

    25 <p>Depending upon the requirements of your application, you can either:</p>

    26 <ul>

    27 <li><p><xref href="GUID-A3AF142B-F9DF-43FD-9D3F-788A74D0C575.dita">use

    28 precompiled CBA button options contained in <parmname>avkon.hrh</parmname></xref></p>

    29 </li>

    30 <li><p><xref href="GUID-5B26AB8E-E20A-4C15-B4F8-812ED9A4A96C.dita">create

    31 your own buttons</xref></p></li>

    32 </ul>

    33 <p>CBA buttons are constructed using the <xref format="html" href="specs/guides/Buttons_API_Specification/Buttons_API_Specification.html" scope="external">Buttons

    34 API</xref>.</p>

    35 </conbody></concept>