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 -->  <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-B05B61B8-1217-441F-BAFA-C209C8F123C5" xml:lang="en"><title>Toolbar

    10 API</title><shortdesc>The Toolbar API is used for enabling quick access to functions

    11 by displaying them in a toolbar.</shortdesc><prolog><metadata><keywords></keywords></metadata></prolog><conbody>

    12 <p>A toolbar contains Avkon buttons. The toolbar supports touch, and can be

    13 with focus or without focus. It contains application-specific buttons (at

    14 least three) that launch application-specific commands. The toolbar content

    15 is application-specific, but you can choose whether the toolbar is displayed

    16 in an application view or not.</p>

    17 <p>The Toolbar API supports two types of toolbars: a fixed toolbar for touch

    18 UI, and a floating toolbar which can also be used in non-touch UIs.</p>

    19 <fig id="GUID-65384C58-D95F-4E3F-A3E8-41B2FBA237BB">

    20 <title>Fixed toolbar, floating toolbar, and toolbar extension</title>

    21 <image href="GUID-F1EFB7C3-BC06-4822-BA37-06B02BECE80A_d0e48067_href.png" scale="90" placement="inline"></image>

    22 </fig>

    23 <p>The fixed toolbar doesn’t have focus, whereas the floating toolbar owns

    24 the focus and it can be used also with navigation and selection keys. By default,

    25 the floating toolbar owns the CBA buttons (<uicontrol>Select</uicontrol> and <uicontrol>Close</uicontrol>)

    26 but the floating toolbar can be defined as not having the CBA buttons with

    27 suitable flags. </p>

    28 <p>The toolbars are also located differently: a fixed toolbar has a permanent

    29 place in the layout but a floating toolbar can be freely located when it is

    30 defined as having a flexible position.</p>

    31 <p>The toolbar extension is a toolbar button that expands the fixed or floating

    32 toolbar. When the extension button is pressed, a grid of toolbar items opens

    33 up. The extension items can be used as actual toolbar items. </p>

    34 <p>The extension button itself looks like an ordinary toolbar button. The

    35 only difference is that there is a default icon for the extension button that

    36 is shown if the application does not change the icon itself.</p>

    37 <p>For user experience guidelines on the toolbar component, please see the <xref href="GUID-EB212C35-5416-4CA7-8091-61B45D78E220.dita">toolbar UI component description</xref>.</p>

    38 <section><p>For information on using the API, see <xref href="GUID-95CE2206-7AE0-48C0-97A7-4E2082F9F662.dita">Enabling

    39 quick access to functions with a toolbar</xref>.</p><p>For the Toolbar API

    40 classes and header files, see Classes

    41 and Definitions.</p></section>

    42 <section><title>Constraints</title><p>This API is valid for all platforms

    43 running on Symbian OS 9.3 or later.</p></section>

    44 <section><title>Emulator support</title><p>This API is supported in the WINS/WINSCW

    45 emulator environment, with the following exception:</p><ul>

    46 <li><p>Tactile feedback is not supported.</p></li>

    47 </ul></section>

    48 </conbody></concept>