--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-B05B61B8-1217-441F-BAFA-C209C8F123C5.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,62 @@
+<?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-B05B61B8-1217-441F-BAFA-C209C8F123C5" xml:lang="en"><title>Toolbar
+API</title><shortdesc>The Toolbar API is used for enabling quick access to functions
+by displaying them in a toolbar.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>A toolbar contains AVKON buttons. The toolbar supports touch, and can be
+with focus or without focus. It contains application-specific buttons (at
+least three) that launch application-specific commands. The toolbar content
+is application-specific, but you can choose whether the toolbar is displayed
+in an application view or not.</p>
+<p>The Toolbar API supports two types of toolbars: a fixed toolbar for touch
+UI, and a floating toolbar which can also be used in non-touch UIs.</p>
+<fig id="GUID-65384C58-D95F-4E3F-A3E8-41B2FBA237BB">
+<title>Fixed toolbar, floating toolbar, and toolbar extension</title>
+<image href="GUID-F1EFB7C3-BC06-4822-BA37-06B02BECE80A_d0e79427_href.png" scale="90" placement="inline"/>
+</fig>
+<p>The fixed toolbar doesn’t have focus, whereas the floating toolbar owns
+the focus and it can be used also with navigation and selection keys. By default,
+the floating toolbar owns the CBA buttons (<uicontrol>Select</uicontrol> and <uicontrol>Close</uicontrol>)
+but the floating toolbar can be defined as not having the CBA buttons with
+suitable flags. </p>
+<p>The toolbars are also located differently: a fixed toolbar has a permanent
+place in the layout but a floating toolbar can be freely located when it is
+defined as having a flexible position.</p>
+<p>The toolbar extension is a toolbar button that expands the fixed or floating
+toolbar. When the extension button is pressed, a grid of toolbar items opens
+up. The extension items can be used as actual toolbar items. </p>
+<p>The extension button itself looks like an ordinary toolbar button. The
+only difference is that there is a default icon for the extension button that
+is shown if the application does not change the icon itself.</p>
+<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>
+<section id="GUID-117C4E37-4C55-4D0A-BA1A-D44200FD74F9"><p>For information
+on using the API, see <xref href="GUID-95CE2206-7AE0-48C0-97A7-4E2082F9F662.dita">Enabling
+quick access to functions with a toolbar</xref>.</p><p>For the Toolbar API
+classes and header files, see Classes and Definitions.</p></section>
+<section id="GUID-BA1F5361-1F8C-45A0-B476-ECDE87234816"><title>Constraints</title><p>This
+API is valid for all platforms running on Symbian OS v9.3 or later.</p></section>
+<section id="GUID-2C270CBB-6AF6-4416-8F0C-29546BF74FF4"><title>Emulator support</title><p>This
+API is supported in the WINS/WINSCW emulator environment, with the following
+exception:</p><ul>
+<li><p>Tactile feedback is not supported.</p></li>
+</ul></section>
+</conbody><related-links>
+<linklist><title>Related APIs</title>
+<link href="GUID-F3EE1000-71A6-4D48-A30B-3D2357BF20FB.dita"><linktext>Generic button
+API</linktext>
+<desc> for creating toolbar buttons</desc>
+</link>
+<link format="html" href="specs/guides/Form_API_Specification/Form_API_Specification.html" scope="peer"><linktext>Form API</linktext>
+<desc> for including editable fields in fixed toolbar extensions</desc>
+</link>
+</linklist>
+</related-links></concept>
\ No newline at end of file