<?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-771AF721-E2D7-41C8-BF97-5BD30D1A28AD" xml:lang="en"><title> Status

pane</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody>

<p>The Status pane displays status information of the current application

and state, as well as general information about the device status, such as

signal strength and battery charge. It occupies the top part of the screen

and comes in two variants: extended and small. The Status pane may also be

totally left out in certain applications or situations.</p>

<p>Extended Status pane is a development of the earlier standard Symbian Status

pane that contained a Context pane. Context pane cannot be used

any more.</p>

<note><p>The status pane used in Idle is a modified extended Status pane. </p></note>

<p>Small Status pane can be used in cases where it is imperative to maximize

Main pane area (for example, Browser). </p>

<p>The Status pane contains the following subpanes:</p>

<ul>

<li><p><xref href="GUID-66EFFCF5-581A-4EE7-B784-8087A1081B6D.dita">Title pane</xref></p></li>

<li><p><xref href="GUID-76FD2A71-E8A3-4C82-9704-3F7F6AD4DFD8.dita">Navi pane</xref></p></li>

<li><p><xref href="GUID-DF3F2FD0-FF68-4CEF-843F-CBC9E84F3A7F.dita">Signal pane</xref></p></li>

<li><p><xref href="GUID-A947B5A8-9138-4FA2-B8D8-2850AEB2F38C.dita">Battery pane</xref></p></li>

<li><p><xref href="GUID-314B1556-5CB5-4BCC-93C0-B22DB849D2D5.dita">Universal indicator

pane</xref></p></li>

<li><p>Digital clock</p></li>

</ul>

<fig id="GUID-CD56E0F0-76CE-4F3E-92E7-6CF2125B9767">

<title>Status pane areas</title>

<image href="GUID-D0FE1B14-706E-4E4D-902E-AB2B25F02464_d0e53018_href.png" scale="70" placement="inline"></image>

</fig>

<section id="GUID-681C48E1-D94F-4960-8BC4-DEB5C8B677DF"><title>Using

the status pane in C++ applications</title><p>The API to use for the status

pane is the Status

pane API. For implementation information, see Using

the status pane API.</p><p>Use the Status pane API for the following

tasks:</p><ul>

<li><p>Creating

the status pane using a resource file</p></li>

<li><p>Accessing

the status pane</p></li>

<li><p>Accessing

controls in the status pane's subpanes</p></li>

<li><p>Showing

and hiding the status pane</p></li>

<li><p>Dynamically

changing status pane layout </p></li>

<li><p>Observing

status pane events</p></li>

</ul><p>Applications can define and modify the title and navi subpanes. For

implementation information on the subpanes in the status pane, see the following

APIs:</p><ul>

<li><p>Title

pane API for the title pane</p></li>

<li><p>Navigation

pane API for the navi pane</p></li>

</ul><p>Use the method <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCEikStatusPaneBase_1_1TPaneCapabilities.html#bc5c25636d87ce1eaa38fc294336bdd5" format="application/java-archive"><codeph>IsAppOwned()</codeph></xref> in the class <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCEikStatusPaneBase_1_1TPaneCapabilities.html" format="application/java-archive"><codeph>CEikStatusPaneBase::TPaneCapabilities</codeph></xref> to test whether

the pane is owned by the application or the server. Applications can only

interact directly with application owned subpanes.</p><p><xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCEikStatusPane.html" format="application/java-archive"><codeph>CEikStatusPane</codeph></xref> is the interface through which applications

use the status pane. This class synchronises the status pane layout with the

server side status pane object. To do this, the method <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCEikStatusPane.html#2d082d2526d324f9c153da7ffde9651c" format="application/java-archive"><codeph>ApplyCurrentSettingsL()</codeph></xref> must be called whenever the

owner application switches to the foreground. </p><p><draft-comment translate="no" time="2008-05-23T11:14">Relationship

between events/similar for entire status pane and subpanes: should be clearer

on what's done where</draft-comment></p><p> The following options are available

for modifying the default behavior of the status pane:  </p><ul>

<li><p>Since the status pane is a compound control, it can be made visible

or invisible like an other control with <codeph>CCoeControl::MakeVisible()</codeph>. <codeph>CCoeControl::MakeVisible()</codeph> can

be called before or after the control is activated. An example of a call to

make the status pane invisible is as follows:  </p><codeblock xml:space="preserve">CEikStatusPane* sp = StatusPane();// Gets a pointer to the status pane in the UI controller 

StatusPane()-&gt;MakeVisible(EFalse); //make pane invisible somewhere in your code</codeblock></li>

<li><p>Accessing and modifying controls inside the status pane.</p><p> The

Status Pane API provides methods for accessing the status pane control and

modifying the status pane layout.   </p><p>If you wish to modify panes within

the status pane, you need to get a pointer to the status pane and then use

one of the following classes and methods: </p><ul>

<li><p><xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknTitlePane.html" format="application/java-archive"><codeph>CAknTitlePane</codeph></xref> for

the title subpane</p></li>

<li><p>Methods defined by the Navigation

pane API for accessing the navi subpane </p></li>

<li><p>The Tabs

API for accessing tabs in the navi subpane.</p></li>

</ul></li>

<li><p>Defining new resources for the status pane to override the default

behavior</p><p> Once you have defined your resources, you may need to use

some of the status pane APIs to achieve the desired effect in your application.

 </p><p>For more information, see the Status

pane API and Navigation

pane API reference documentation.   </p></li>

<li><p>You could also possibly derive your own classes from the available

classes or their base classes to customize your own controls. </p></li>

</ul></section>

</conbody></concept>