<?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-0387B02E-9B81-5E61-A33E-D644251424A2-GENID-1-10-1-6-1-1-4-1-6-1-7-1-11-1" xml:lang="en"><title>Layout

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

<p>Many factors have to be taken into consideration when laying out controls.

Component controls are normally laid out within their containers according

to the prevailing UI policy, skin, font, text style, zoom-factor and the sizes

and shapes of the controls themselves. A change to any one of these might

necessitate a new layout. </p>

<p>The Control Framework supports run-time layout management with the <xref href="GUID-A622B8C7-60F4-38E8-B102-14883BCBA249.dita"><apiname>MCoeLayoutManager</apiname></xref> interface.

Each compound control knows which layout manager to call when it changes size.

The layout manager then takes responsibility for making any adjustments to

the layout. </p>

<p>A layout manager is associated with a compound control using: </p>

<codeblock id="GUID-B2CAA11F-EAEF-5583-A86D-BEF8A279EF22-GENID-1-10-1-6-1-1-4-1-6-1-7-1-11-1-2-4" xml:space="preserve"> IMPORT_C virtual void SetLayoutManagerL(MCoeLayoutManager* aLayout);</codeblock>

<p>Note that this call passes 'ownership' so the caller does not need to retain

a pointer. A layout manager may be attached to more than one control so it

must implement its own reference count and delete itself when the count becomes

zero. <codeph>SetLayoutManagerL()</codeph> is also used to dissociate a layout

manager from a control by passing either NULL or a pointer to a different

layout manager. </p>

<p>The Control Framework does not provide any concrete layout managers. This

is the responsibility of the UI variant library or the application developer. </p>

<p>Though layout managers are now built into the control framework their use

is optional. </p>

</conbody></concept>