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 -->  <!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></keywords></metadata></prolog><conbody>

    10 <fig id="GUID-CBFDE06F-86CA-4ADA-AB5B-CE9E46DEC576"><title>Application with Options and Exit softkeys, portrait and landscape

    11 views</title><image href="GUID-5F9E2762-855A-4DE6-A11B-A5F0D51E19D9_d0e53650_href.png"></image></fig>

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

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

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

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

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

    17 handling</xref>.</p>

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

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

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

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

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

    23 <ul>

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

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

    26 </li>

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

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

    29 </ul>

    30 <p>CBA buttons are constructed using the Buttons API.</p>

    31 </conbody></concept>