AVKON Title Pane API

Changes in AVKON Title Pane API documentation

1.0 30.12.2008 Approved

Contents

Changes

None.

Purpose

Title pane is a control shown on the Status pane. It is used for displaying some text or an image associated with the foreground application or the current view of the foreground application.

Constraints

This API is valid for all product platforms.

Classification and release information

This API is an SDK API.This document is valid from S60 5th Edition.

Emulator support

This API is fully supported in the WINS/WINSCW emulator environment.

API description

CAknTitlePane is a Framework API. Users retrieve it from the Status pane and set text or image to it. The number of text rows shown on the Title pane can be configured.

Use cases

  • Set some text to the title pane.

  • Set some image to the title pane.

API class structure

The following class diagram shows its class structure.


Related APIs
  • CAknTitlePane

Using the Title pane

Set some text to Title pane

The Title pane can be used to show some text.

Set some picture to Title pane

The Title pane can be used to show some image.

Error handling

None.

Memory overhead

None.

Extensions to the API

None.

Limitations of the API

Title pane is only used as a pane on the Status pane. It cannot be used as a common control. The following code shows how to retrieve it from the Status pane. 

             
              CAknTitlePane* title = static_cast<CAknTitlePane>
              

                      (StatusPane()->ControlL(TUid::Uid(EEikStatusPaneUidTitle)));