Navi -pane

diff -r 80ef3a206772 -r 48780e181b38 Symbian3/SDK/Source/GUID-76FD2A71-E8A3-4C82-9704-3F7F6AD4DFD8.dita --- a/Symbian3/SDK/Source/GUID-76FD2A71-E8A3-4C82-9704-3F7F6AD4DFD8.dita Fri Jul 16 17:23:46 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-76FD2A71-E8A3-4C82-9704-3F7F6AD4DFD8.dita Tue Jul 20 12:00:49 2010 +0100 @@ -9,13 +9,12 @@ --> -Navi -pane +Navi pane

The principal uses of the Navi pane are to display information about the current state and view, and to help the user to navigate in the application.

- + Navi pane - +

Depending on the context, the Navi pane contains elements presented in the following table.

@@ -32,8 +31,9 @@

Tabs

Tabs are used to view parallel data views alternatively. Arrow indicators -are used only for navigation texts.

Each tab has either a graphic or -a text (or both) as a label. The following tab layouts can be used:

Two tabs
Three tabs
Four tabs

Navigation text (icon+text)

- +

Navigation text is displayed in the Navi pane when similar items can be browsed by scrolling horizontally, such as dates in Calendar. @@ -55,7 +55,7 @@

Indicators

- +

In editors, the Navi pane contains editing indicators. See Indicators for @@ -63,9 +63,9 @@

Folder structure indication

- + -

Opened sub-folders are indicated in the Navi pane.

Opened subfolders are indicated in the Navi pane.

Application-specific content

@@ -74,61 +74,21 @@

Empty pane

- +

The Navi pane can be empty.

-Default touch -events for ungrouped soft notification - - - -
User action
-
State change
-
Feedback
- - - - -
Touch down on navigation text or navigation arrow
-
Application specific
-
Tactile: In case of activity, basic button effect and audio feedback -is provided.
- - -
Touch down and hold on navigation text
-
Inactive
-
Tactile: No effect
- - -
Touch down and hold on arrows
-
This action performs a “key repeat”, similar to many touch downs -and releases on arrow
-
Tactile: Sensitive button effect and audio feedback is provided -with key repeat action.
- - -
Touch release
-
No effect
-
Tactile: No effect
- - - -
-

Using -the navi pane in applications

The API to use for the Navi pane is -the Navigation pane API. If you use tabs in the Navi pane, -the API for controlling the tabs is the Tabs API. Applications can implement an observer to handle -the touch events in the Navi pane area.

For the indicators -in the Navi pane, use the Indicators API.

For implementation information -on the Navi pane, see Using the Navigation pane API. For implementation information -on tabs, see Using the Tabs API.

The MAknNaviDecoratorObserver class -provides touch support for the tab arrows in the Navi pane. To set the observer, -use the CAknNavigationDecorator::SetNaviDecoratorObserver() method.

To -create a tab group in the Navi pane, use the CAknNavigationControlContainer::CreateTabGroupL(). -This is a factory method for a pre-implemented navigation pane tab group control.

Using the navi pane in +C++ applications

The API to use for the Navi pane is the Navigation pane API. If you use tabs in the Navi pane, the API for +controlling the tabs is the Tabs +API.

For the indicators in the Navi pane, use the Indicators API.

For implementation information on the Navi pane, +see Using +the Navigation pane API. For implementation information on tabs, see Using +the Tabs API.

The class MAknNaviDecoratorObserver provides touch support for the tab arrows in the Navi pane. To set +the observer, use the method CAknNavigationDecorator::SetNaviDecoratorObserver().

To +create a tab group in the Navi pane, use the method CreateTabGroupL() in the class CAknNavigationControlContainer. This is a factory +method for a pre-implemented navigation pane tab group control.