diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-EB212C35-5416-4CA7-8091-61B45D78E220.dita --- a/Symbian3/SDK/Source/GUID-EB212C35-5416-4CA7-8091-61B45D78E220.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-EB212C35-5416-4CA7-8091-61B45D78E220.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,190 +1,191 @@ - - - - - -Toolbar -

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 Options menu.

- -Toolbar - - -

A tooltip is an information pop-up containing information regarding each -button must be shown.

-

Following toolbar button types can be used:

- -

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, for example, depending on focused item in the view or currently -available services. Application may change the buttons according to product -concept.

-

The order of the toolbar buttons in different orientations is according -to the reading direction 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.

-Appearance order -of toolbar functions - - - -Function type -Description - - - - -Call -Call initiation related functions - - -Reply -Replying to a message - - -Send -For sending the content in focus - - -Create new -For creating a new message, note, folder, contact or some other item - - -View switching -For functions such as Go-to or View mode switching - - -Editing -For switching to editing mode - - -Opening extension -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, for example, Insert -extension for inserting image, video, -presentation and so on. - - -Delete -Deleting the item in focus - - -More -extension -For opening the toolbar extension “More” in case the functions within -the extension are various kinds and cannot be grouped. - - - -
-

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.

-

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.

- -Toolbar button states: example of ON/OFF type of button - - -
Floating toolbar

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.

Floating toolbar owns the focus, and thus it can be used only if -other content in the view does not need the focus. It means that floating -toolbar cannot be used with lists and grids.

Opening and closing the -floating toolbar can be done with the Show toolbar / Hide -toolbar command via the Options menu. In this case the toolbar -is open by default.

Floating toolbar can also be designed to be opened -via MSK labeled as Toolbar. For closing the toolbar, -there has to be then a Hide 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. Time-out can be used for closing the toolbar.

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, for example, in case only three buttons -fit the layout.

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.

-
Floating toolbar -extension

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 Appearance order of toolbar functions. The button has a default graphic, -which the application can change if needed.

Toolbar extension buttons -are for similar actions as buttons in toolbar, which means the same types -and rules apply for toolbar extension buttons. Extension should be used for -accessing a set of logically similar options, for example, when selecting -content to be inserted to a message or for adjusting imaging session related -values in camera.

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.

-
Toolbar component -in touch UI

In touch UI the toolbar is either fixed in the layout, -or a floating component. Both toolbars cannot exist in one view.

Toolbars -are view specific, thus all views of an application do not have to have a -toolbar.

Selection in touch toolbars is done with a single tap, and -related tooltip is shown with stylus down.

-
Floating toolbar -in touch UI

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.

Floating toolbar owns the focus also in -touch UI, and thus cannot be used in views that have focus for main pane content.

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 time-out -or by selecting a function.

-
Fixed toolbar -in touch UI

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.

Fixed toolbar does not have -a highlight, and thus it can be used in all views (whether main pane needs -the highlight or not).

Fixed toolbar cannot be opened or closed, but -it is always visible. Toolbar can be hidden in case other controls are also -hidden (in full screen views).

-Toolbar in touch UI fixed in the layout - -
-
Toolbar extension -in touch UI

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.

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, -for example, 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.

In case editor field(s) exists, there is less space for -buttons in landscape layout compared to portrait layout.
-
Using -toolbars in C++ applications

The APIs to use for creating a toolbar -are the Toolbar API for -the toolbar itself and the Generic -button API for the buttons in the toolbar.

For implementation -information, see Enabling -quick access to functions with a toolbar.

+ + + + + +Toolbar +

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 Options menu.

+ Toolbar buttons are Generic +buttons that have touch functionality. + +Toolbar + + +

A tooltip is an information pop-up containing information regarding each +button must be shown.

+

Following toolbar button types can be used:

+
    +

  • Command button offering direct action (functions/view access) +like Send or New contact with a button press feedback. Related +tooltip indicates the function of the button. Command button may have a long +press functionality included such as Fast forward.

    • +

  • ON/OFF button can be used for active/inactive type of functions +such as Loudspeaker or Font italics. 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.

    • +

  • Mode toggle button can be used for switching between several +modes as in Flash. Button icon graphic and tooltip change and should +indicate the current status.

    • +
+

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, for example, depending on focused item in the view or currently +available services. Application may change the buttons according to product +concept.

+

The order of the toolbar buttons in different orientations is according +to the reading direction 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.

+Appearance order +of toolbar functions + + + +Function type +Description + + + + +Call +Call initiation related functions + + +Reply +Replying to a message + + +Send +For sending the content in focus + + +Create new +For creating a new message, note, folder, contact or some other item + + +View switching +For functions such as Go-to or View mode switching + + +Editing +For switching to editing mode + + +Opening extension +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, for example, Insert -extension for inserting image, video, +presentation and so on. + + +Delete +Deleting the item in focus + + +More -extension +For opening the toolbar extension “More” in case the functions within +the extension are various kinds and cannot be grouped. + + + +
+

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.

+

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.

+ +Toolbar button states: example of ON/OFF type of button + + +
Floating toolbar

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.

Floating toolbar owns the focus, and thus it can be used only if +other content in the view does not need the focus. It means that floating +toolbar cannot be used with lists and grids.

Opening and closing the +floating toolbar can be done with the Show toolbar / Hide +toolbar command via the Options menu. In this case the toolbar +is open by default.

Floating toolbar can also be designed to be opened +via MSK labeled as Toolbar. For closing the toolbar, +there has to be then a Hide 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. Time-out can be used for closing the toolbar.

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, for example, in case only three buttons fit the +layout.

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.

+
Floating toolbar +extension

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 Appearance order of toolbar functions. The button has a default graphic, +which the application can change if needed.

Toolbar extension buttons +are for similar actions as buttons in toolbar, which means the same types +and rules apply for toolbar extension buttons. Extension should be used for +accessing a set of logically similar options, for example, when selecting +content to be inserted to a message or for adjusting imaging session related +values in camera.

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.

+
Toolbar component +in touch UI

In touch UI the toolbar is either fixed in the layout, +or a floating component. Both toolbars cannot exist in one view.

Toolbars +are view specific, thus all views of an application do not have to have a +toolbar.

Selection in touch toolbars is done with a single tap, and +related tooltip is shown with stylus down.

+
Floating toolbar +in touch UI

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.

Floating toolbar owns the focus also in +touch UI, and thus cannot be used in views that have focus for main pane content.

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 time-out +or by selecting a function.

+
Fixed toolbar +in touch UI

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.

Fixed toolbar does not have +a highlight, and thus it can be used in all views (whether main pane needs +the highlight or not).

Fixed toolbar cannot be opened or closed, but +it is always visible. Toolbar can be hidden in case other controls are also +hidden (in full screen views).

+Toolbar in touch UI fixed in the layout + +
+
Toolbar extension +in touch UI

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.

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, +for example, 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.

In case editor field(s) exists, there is less space for +buttons in landscape layout compared to portrait layout.
+
Using +toolbars in applications

The APIs to use for creating a toolbar +are the Toolbar API for +the toolbar itself and the Generic +button API for the buttons in the toolbar.

For implementation +information, see Enabling +quick access to functions with a toolbar.

 \ No newline at end of file