<?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-4067B0E6-9431-4325-95F7-78B143EED326" xml:lang="en"><title>Softkeys
and basic softkey configuration</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>The Symbian platform supports two softkeys and labels the Selection key
in the middle of the Control pane. This, in effect, looks like a "middle softkey".
Touch UI does not have the middle softkey label visible, refer to <xref href="GUID-BB8B3A11-0BBC-4759-A7F4-A28C9E70573F.dita">Touch
support for common UI components</xref>. The softkey labels are placed in
the control pane (the bottom area of the screen). The left and right softkeys
always have textual labels, but the Selection key can also have two icons
in certain situations.</p>
<p>The three softkey configurations supported in the Symbian UI style are
the following:</p>
<ul>
<li><p>Basic Symbian portrait-oriented UI with softkeys immediately below
the screen (the middle softkey label is visible) </p></li>
<li><p>Symbian UI with side softkeys in landscape (both left and right rotation
possible, middle softkey label not possible) </p></li>
<li><p>Symbian UI with bottom softkeys in landscape (middle softkey label
not possible). Not available for Touch UI.</p></li>
</ul>
<p>For more details on the functions assigned to softkeys, see <xref href="GUID-959AB527-12A7-4BDB-B01F-F0868E60D237.dita">Where
the Symbian user interface belongs </xref>and <xref href="GUID-26435FE1-D912-4AA2-96EE-82B35DA231E6.dita">Typical
functions of the standard keys</xref>. </p>
<section id="GUID-821EA4E9-F6D3-48A4-8D69-DDEBFD6E90F0"><title>Using
softkeys in C++ applications</title><p>The API to use for softkeys is the <xref format="html" href="specs/guides/Buttons_API_Specification/Buttons_API_Specification.html" scope="peer">Buttons API</xref>. For implementation information, see <xref format="html" href="specs/guides/Buttons_API_Specification/Buttons_API_Specification.html#Buttons_API_Specification.topic3" scope="peer">Using the Buttons API</xref>.</p></section>
</conbody></concept>