<?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>+
−