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 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-4067B0E6-9431-4325-95F7-78B143EED326" xml:lang="en"><title>Softkeys

    13 and basic softkey configuration</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>The Symbian platform supports two softkeys and labels the Selection key

    15 in the middle of the Control pane. This, in effect, looks like a "middle softkey".

    16 Touch UI does not have the middle softkey label visible, refer to <xref href="GUID-BB8B3A11-0BBC-4759-A7F4-A28C9E70573F.dita">Touch

    17 support for common UI components</xref>. The softkey labels are placed in

    18 the control pane (the bottom area of the screen). The left and right softkeys

    19 always have textual labels, but the Selection key can also have two icons

    20 in certain situations.</p>

    21 <p>The three softkey configurations supported in the Symbian UI style are

    22 the following:</p>

    23 <ul>

    24 <li><p>Basic Symbian portrait-oriented UI with softkeys immediately below

    25 the screen (the middle softkey label is visible) </p></li>

    26 <li><p>Symbian UI with side softkeys in landscape (both left and right rotation

    27 possible, middle softkey label not possible) </p></li>

    28 <li><p>Symbian UI with bottom softkeys in landscape (middle softkey label

    29 not possible). Not available for Touch UI.</p></li>

    30 </ul>

    31 <p>For more details on the functions assigned to softkeys, see <xref href="GUID-959AB527-12A7-4BDB-B01F-F0868E60D237.dita">Where

    32 the Symbian user interface belongs </xref>and <xref href="GUID-26435FE1-D912-4AA2-96EE-82B35DA231E6.dita">Typical

    33 functions of the standard keys</xref>. </p>

    34 <section id="GUID-821EA4E9-F6D3-48A4-8D69-DDEBFD6E90F0"><title>Using

    35 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>

    36 </conbody></concept>