Symbian3/SDK/Source/GUID-A4F3738C-CBFD-4151-9132-26FE05966715.dita
changeset 8 ae94777fff8f
parent 7 51a74ef9ed63
child 13 48780e181b38
--- a/Symbian3/SDK/Source/GUID-A4F3738C-CBFD-4151-9132-26FE05966715.dita	Wed Mar 31 11:11:55 2010 +0100
+++ b/Symbian3/SDK/Source/GUID-A4F3738C-CBFD-4151-9132-26FE05966715.dita	Fri Jun 11 12:39:03 2010 +0100
@@ -1,35 +1,44 @@
-<?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, portrait and landscape
-views</title><image href="GUID-A69D2707-CB47-42C2-A6E9-5FB9BD86A30B_d0e72940_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>
-<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>
+<?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>
\ No newline at end of file