Tabs API: API Description

Tabs API provides support for creating tab group controls on the navigation pane. Tab group controls consists of tabs. Each tab can be accessed, new tabs can be created, or tabs can be replaced.

The navigation pane control contains factory methods for pre-implemented navigation pane tab group control type: CAknNavigationControlContainer::CreateTabGroupL()). This method returns a navigation decorator object. A decorator object contains the tab group control itself and in addition, it provides support for navigation arrows, etc.

Tabs API 's most important classes are CAknTabGroup and MAknTabObserver. Tab group controls can be created at runtime, or from resource files, using the NAVI_DECORATOR resource headers.

Tabs API can be used by any application that is designed to show information outside the view area of the application.

Use Cases

The main use cases of Tabs API are:

1. Creating tab group control from resource
2. Accessing tab group control created from resource
3. Creating tab group control dynamically from resource
4. Creating tab group control dynamically
5. Creating a pre-implemented tab group
6. Modifying tabs of tab group control
7. Observing tab group control events

API Class Structure

Tabs API contains small number of classes providing functionality of the interface. The main classes are: CAknTabGroup, MaknTabObserver, MAknNavigationObserver.