8 Contributors: |
8 Contributors: |
9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
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> |
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 |
13 <fig id="GUID-A84D5799-70F3-46CB-90B6-05A455B0499E"><title>Application with Options and Exit softkeys in portrait |
14 views</title><image href="GUID-A69D2707-CB47-42C2-A6E9-5FB9BD86A30B_d0e72940_href.png"/></fig> |
14 and landscape views</title><image href="GUID-A69D2707-CB47-42C2-A6E9-5FB9BD86A30B_d0e67789_href.png"/></fig> |
15 <p>The Symbian platform uses Control Button Area (CBA) resources to set |
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 |
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 |
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 |
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 |
19 to your application for <xref href="GUID-4941C035-C359-4968-9BD5-31F44EE5F810.dita">command |
20 handling</xref>.</p> |
20 handling</xref>.</p> |
|
21 <note> |
|
22 <ul> |
|
23 <li><p>The left softkey and right softkey are placed inside the |
|
24 CBA.</p></li> |
|
25 <li><p>You must disable item-specific softkeys.</p></li> |
|
26 <li><p>If there is no highlight then, the left softkey is hidden.</p> |
|
27 </li> |
|
28 </ul> |
|
29 </note> |
21 <p>When a mobile device user selects an <parmname>Options</parmname> softkey, |
30 <p>When a mobile device user selects an <parmname>Options</parmname> softkey, |
22 the application framework displays the <parmname>Options</parmname> menu based |
31 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 |
32 upon the definitions in the <xref href="GUID-5918ED8A-B26B-41A0-94A6-AB6D51BF80A1.dita">menu |
24 bars</xref> resources.</p> |
33 bars</xref> resources.</p> |
25 <p>Depending upon the requirements of your application, you can either:</p> |
34 <p>Depending upon the requirements of your application, you can either:</p> |