<?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-EB212C35-5416-4CA7-8091-61B45D78E220" xml:lang="en"><title>Toolbar</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<section><p>The toolbar offers quick access to some of the key functions in

the application view. All of the functions must also be found from the <uicontrol>Options</uicontrol> menu. </p><fig id="GUID-946D2784-A151-4EBA-AC48-13007B12D75B">

<title>Toolbar</title>

<image href="GUID-0CD826C3-9DD9-46DD-A5A6-9093B8772993_d0e60110_href.png" scale="33" placement="inline"/>

</fig><p>A tooltip i.e. an information pop-up containing information regarding

each button must be shown.</p><p>Following toolbar button types can be used:</p><ul>

<li><p><b>Command button</b> offering direct action (functions/view access)

like <i>Send</i> or <i>New contact</i> with a button press feedback. Related

tooltip indicates the function of the button. Command button may have a long

press functionality included such as <i>Fast forward</i>.</p></li>

<li><p><b>On/Off button</b> can be used for active/inactive type of functions

such as <i>Loudspeaker</i> or<i> Font italics</i>. Button has related latched

down effect. Button icon graphic and tooltip indicate the function of the

button, and they stay the same regardless of the button state. No long tap

allowed.</p></li>

<li><p><b>Mode toggle button</b> can be used for switching between several

modes as in <i>Flash</i>. Button icon graphic and tooltip change and should

indicate the current status.</p></li>

</ul><p>Toolbar buttons are view specific, thus within one application some

views may have toolbar and some do not. It is recommended though to keep the

toolbars as consistent as possible within an application. Changing toolbar

buttons within one view is not allowed, but button can be dimmed in case function

is not available, e.g. depending on focused item in the view or currently

available services. Application may change the buttons according to product

concept.</p><p>The order of the toolbar buttons in different orientations

is according to the reading direction e.g. the first item is placed topmost

when the toolbar is vertical and leftmost when the toolbar is horizontal in

western languages. The appearance of functions in Toolbar should follow the

order presented below.</p><table id="GUID-D8D1CBB2-C07E-43EA-80E5-9163865A0B2D">

<title>Appearance order of toolbar functions</title>

<tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/>

<thead>

<row>

<entry>Function type</entry>

<entry>Description</entry>

</row>

</thead>

<tbody>

<row>

<entry>Call</entry>

<entry>Call initiation related functions</entry>

</row>

<row>

<entry>Reply</entry>

<entry>Replying to a message</entry>

</row>

<row>

<entry>Send</entry>

<entry>For sending the content in focus</entry>

</row>

<row>

<entry>Create new</entry>

<entry>For creating a new message, note, folder, contact or some other item</entry>

</row>

<row>

<entry>View switching</entry>

<entry>For functions such as Go-to or View mode switching</entry>

</row>

<row>

<entry>Editing</entry>

<entry>For switching to editing mode</entry>

</row>

<row>

<entry>Opening extension</entry>

<entry>For opening the toolbar extension in case all the functions within

the extension are a collection of options of similar type and can be grouped

under one command e.g. Insert -extension for inserting image, video, presentation

etc. </entry>

</row>

<row>

<entry>Delete</entry>

<entry>Deleting the item in focus</entry>

</row>

<row>

<entry>More -extension</entry>

<entry>For opening the toolbar extension “More” in case the functions within

the extension are various kinds and cannot be grouped.</entry>

</row>

</tbody>

</tgroup>

</table><p>Application specific commands that do not fit into any function

type described above are to be placed between Create new and Opening the extension

in the order list.</p><p>The application may decide the initial state of On/Off

and Mode toggle button in application launch. They can also be reset or resumed

from the previous session.</p><fig id="GUID-2D9D4495-4AA3-4DA8-9AC7-B989189CD2F3">

<title>Toolbar button states: example of On/Off type of button</title>

<image href="GUID-9E0C8892-E67F-4DC9-8253-2F65611AD4C6_d0e60273_href.png" scale="50" placement="inline"/>

</fig></section>

<section><title>Floating toolbar</title><p>Floating toolbar is a component

for showing the key functions on top of the Main pane or full screen content.

It can be used in non-touch UI, but also in touch UI.</p><p>Floating toolbar

owns the focus, thus it can be used only if other content in the view does

not need the focus. I.e. floating toolbar cannot be used with lists and grids.</p><p>Opening

and closing the floating toolbar can be done with the <uicontrol>Show toolbar</uicontrol> / <uicontrol>Hide

toolbar</uicontrol> command via the Options menu. In this case the toolbar

is open by default.</p><p>Floating toolbar can also be designed to be opened

via MSK labeled as <uicontrol>Toolbar</uicontrol>. For closing the toolbar,

there has to be then a <uicontrol>Hide</uicontrol> button or the toolbar is

closed after selecting a function. Navigation keys can be used as a shortcut

for opening and closing the toolbar, when not used for anything else in the

view. Timeout can be used for closing the toolbar.</p><p>There can be 3-6

buttons in the floating toolbar depending on used resolution. Thus the most

important functions must be designed to be the first ones in the toolbar;

so that they are visible e.g. in case only three buttons fit the layout.  </p><p>When

the toolbar is open, it owns the Selection key for selecting the focused toolbar

button. Toolbar does not own the right and left softkeys. The user can move

the focus over the toolbar buttons with the Arrow keys (left and right). The

focus loops, and the toolbar itself does not scroll.</p></section>

<section><title>Floating toolbar extension</title><p>Toolbar button can be

reserved for opening a toolbar extension, where more options can be found.

Placement of the extension button within toolbar can be found from the appearance

order in the table <xref href="GUID-EB212C35-5416-4CA7-8091-61B45D78E220.dita#GUID-EB212C35-5416-4CA7-8091-61B45D78E220/GUID-D8D1CBB2-C07E-43EA-80E5-9163865A0B2D">Appearance

order of toolbar functions</xref>. The button has a default graphic, which

the application can change if needed. </p><p>Toolbar extension buttons are

for similar actions as buttons in toolbar i.e. the same types and rules apply

for toolbar extension buttons. Extension should be used for accessing a set

of logically similar options e.g. when selecting content to be inserted to

a message or for adjusting imaging session related values in camera. </p><p>Extension

can have 2 – 12 buttons (3x4 in landscape and 4x3 in portrait). The filling

order follows the grid filling rules, thus for example most important one

should be placed as first. In floating toolbar extension, the last extension

button is reserved for closing the toolbar. </p></section>

<section><title>Toolbar component in touch UI</title><p>In touch UI the toolbar

is either fixed in the layout, or a floating component. Both toolbars cannot

exist in one view.</p><p>Toolbars are view specific, thus all views of an

application do not have to have a toolbar.</p><p>Selection in touch toolbars

is done with a single tap, and related tooltip is shown with stylus down.</p></section>

<section><title>Floating toolbar in touch UI</title><p>The number of floating

toolbar buttons in the nHD (640 x 360 pixels) layout is three. In case floating

toolbar is used in full screen, there can be four buttons. </p><p>Floating

toolbar owns the focus also in touch UI, and thus cannot be used in views

that have focus for main pane content.</p><p>Floating toolbar can be opened

and closed as in non-touch UI via the Options menu or with the Selection key,

or it can be opened by tapping the main pane area. In this case closing is

done by tapping the main pane area again, with timeout or by selecting a function.</p></section>

<section><title>Fixed toolbar in touch UI</title><p>The number of fixed toolbar

buttons in the nHD (640 x 360 pixels) layout is three. It reserves own space

from the layout and does not cover the content of main pane area. </p><p>Fixed

toolbar does not have a highlight, and thus it can be used in all views (whether

main pane needs the highlight or not).</p><p>  Fixed toolbar cannot be opened

or closed, but it is always visible. Toolbar can be hidden in case other controls

are also hidden i.e. in full screen views.</p><fig id="GUID-C5A359DF-1C8F-42D3-B86F-79A49EB97D70">

<title>Toolbar in touch UI fixed in the layout</title>

<image href="GUID-4BB85136-0E46-47BD-83FD-A918DECF7CDD_d0e60351_href.png" scale="50" placement="inline"/>

</fig></section>

<section><title>Toolbar extension in touch UI</title><p>As in non-touch UI,

toolbars can have extensions also in touch UI. For floating toolbar in touch

UI, the same rules apply as defined for floating toolbar extension in general.

In touch UI, the toolbar extension can always be closed with the same toolbar

button as it was opened, or by tapping outside the extension area. </p><p>In

addition to general extension rules, the toolbar extension for

fixed toolbar has certain specific guidelines. Besides buttons, the extension

of fixed toolbar can include editor fields e.g. for entering an URL or for

the Find function in the browser. The most important editor field is to be

the topmost and has the cursor by default.</p><note> In case editor field(s)

exists, there is less space for buttons in landscape layout compared to portrait

layout.</note></section>

<section><title>Using toolbars in C++

applications</title><p>The APIs to use for creating a toolbar are the <xref href="GUID-B05B61B8-1217-441F-BAFA-C209C8F123C5.dita">Toolbar API</xref> for the

toolbar itself and the <xref href="GUID-F3EE1000-71A6-4D48-A30B-3D2357BF20FB.dita">Generic

button API</xref> for the buttons in the toolbar.</p><p>For implementation

information, see <xref href="GUID-95CE2206-7AE0-48C0-97A7-4E2082F9F662.dita">Enabling

quick access to functions with a toolbar</xref>.</p></section>

</conbody></concept>