Mercurial Mercurial > oss > MCL > sftools > depl > docscontent / diff
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Symbian3/SDK/Source/GUID-771AF721-E2D7-41C8-BF97-5BD30D1A28AD.dita
changeset 0 89d6a7a84779 
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-771AF721-E2D7-41C8-BF97-5BD30D1A28AD.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,96 @@
+<?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>
\ No newline at end of file
MCL/sftools/depl/docscontent