Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



How to get and set subpane contents


Getting subpane contents

Before you attempt to get a status pane subpane’s contents, check the subpane exists and is application-owned. To do this, use the CEikStatusPaneBase::PaneCapabilities() function with the subpane id as a parameter.

If the subpane exists, and is application-owned, get the subpane’s contents using the CEikStatusPaneBase::ControlL() function with the subpane id as a parameter.

[Top]


Setting subpane contents

Before you attempt to get a status pane subpane’s contents, check the subpane exists, and is application-owned using the CEikStatusPaneBase::PaneCapabilities() function with the subpane id as a parameter.

If the subpane exists, and is application-owned, create a new control to go into the subpane. Any valid control, or custom control, can be used.

Get a pointer to the existing control using CEikStatusPaneBase::ContainerControlL() with the subpane id as a parameter.

Put the new control into the subpane, indexed by pane id, and record the old contents returned using CEikStatusPaneBase::SwapControlL(). When the old control is returned, it is up to you to delete it. Your newly installed control is deleted by the status pane when it is itself destroyed.