<?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-A3AF142B-F9DF-43FD-9D3F-788A74D0C575" xml:lang="en"><title>Using
precompiled CBA button resources</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>To define <xref href="GUID-0F8D0399-58CD-4EB6-82DF-75D6BE5B0A84.dita#GUID-0F8D0399-58CD-4EB6-82DF-75D6BE5B0A84/GUID-5F749184-C804-41FC-BA81-038783BDC967">resources</xref> for
a precompiled <xref href="GUID-A4F3738C-CBFD-4151-9132-26FE05966715.dita">CBA button</xref> option:</p>
<ol>
<li id="GUID-5225D60A-D8D2-4FB0-B938-F2FAE91F4955"><p>Determine
the CBA button requirements of your application.</p></li>
<li id="GUID-C7B01995-16A6-45AD-8616-FFB290870BC2"><p>Declare <parmname>cba
= precompiled symbolic ID in avkon.hrh</parmname> in the <xref href="GUID-23A60DE7-B72D-41BD-9F1E-882D31A7E3C7.dita"><parmname>EIK_APP_INFO</parmname></xref> or <xref href="GUID-B238952B-1691-49F4-B8B9-9F755011A7DD.dita"><parmname>AVKON_VIEW</parmname></xref> resource.
where <parmname>precompiled symbolic ID in avkon.hrh</parmname> is an <xref href="GUID-CBB00F6A-CBA7-4872-B0A1-A86A863725F5.dita">enumerated value</xref> in
the <parmname>avkon.hrh</parmname> file delivered with the SDK and in the <parmname>./Epoc32/include</parmname> folder.
An example is as follows:</p>
<itemgroup>
<codeblock id="GUID-6D73CAC8-36C6-4AC1-B5A3-E53B97F9B6FF" xml:space="preserve">RESOURCE EIK_APP_INFO
    {
    menubar = r_value_menubar;
    cba = R_AVKON_SOFTKEYS_OPTIONS_EXIT;
    }</codeblock>
<p>In this case, <parmname>Options</parmname> and <parmname>Exit</parmname> appear
above the softkeys at runtime.</p>
<p>The <parmname>Options</parmname> softkey is bound to a command that
results in the application framework opening the options menu based on the <parmname>MENU_BAR</parmname> resource.
The <parmname>Exit</parmname> softkey returns the <parmname>EAknSoftkeyExit</parmname> command,
which would need to be handled in the appropriate place for command handling
in your application architecture. Note that the Symbian platform enumerations
are in the <parmname>avkon.hrh</parmname> file. In general, you can map the
commands returned from the CBA options by comparing the names of the symbolic
IDs to the symbolic names in the enumerated list.</p>
</itemgroup>
</li>
<li id="GUID-EBEB81FE-4A51-4E22-A815-BA49CB7E3E03"><p>If required, <xref href="GUID-4941C035-C359-4968-9BD5-31F44EE5F810.dita">handle the commands</xref> caused
by the selection of a CBA option in your application.</p></li>
</ol>
</conbody></concept>