diff -r ebc84c812384 -r 46218c8b8afa Symbian3/PDK/Source/GUID-352850A9-227F-45DB-8DCD-C6268954B4ED.dita --- a/Symbian3/PDK/Source/GUID-352850A9-227F-45DB-8DCD-C6268954B4ED.dita Thu Mar 11 15:24:26 2010 +0000 +++ b/Symbian3/PDK/Source/GUID-352850A9-227F-45DB-8DCD-C6268954B4ED.dita Thu Mar 11 18:02:22 2010 +0000 @@ -1,60 +1,60 @@ -<?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-352850A9-227F-45DB-8DCD-C6268954B4ED" xml:lang="en"><title>Window -owning and non-window owning controls</title><prolog><metadata><keywords/></metadata></prolog><conbody> -<section id="GUID-A403D2F8-7ED3-4DE6-92E8-4B16CC646CA6"><title>Window-owning -controls</title> -<p>Window-owning controls have the same size and position as a window in -the display. Each window has a one-to-one relationship with the control that -covers it, and shares its behavior with that control.</p> -<p>Examples of window-owning controls include:</p> -<ul> -<li><p>top-level control in <xref href="GUID-B5DE1C86-2B16-4B22-887F-7079E54A8ED6.dita">Traditional -Symbian architecture</xref></p></li> -<li><p>the subpanes in the status pane</p></li> -<li><p>pop-up windows, when a sense of layering is required</p> -</li> -</ul> -<p>The following code snippet is an example of the second phase construction -of a window-owning control:</p> -<codeblock id="GUID-234E4AC3-2FC8-4AD9-8B72-0FBA478E1D5A" xml:space="preserve">CMyControl::ConstructL() - { - CreateWindowL(); // This makes the control window- - // owning - SetRectL(ClientRect()); // This sets the control’s - // size - ActivateL(); // This must be called before - // the control can be drawn - } -</codeblock> -<p><parmname>ClientRect()</parmname> returns the screen area available -to the application for drawing. This typically does not include the space -that is reserved for the status/control panes.</p> -<p>For more information, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/guide/Application-Framework-subsystem-guide/UIControlFrameworkGuide/UIControlFrameworkGuide2/RunTimeControlHierarchy.guide.html#ApplicationFrameworkOverview%2eUIControlFrameworkGuide2%2ehierarchy" format="application/java-archive">The run-time control hierarchy</xref></p> -</section> -<section id="GUID-13D754E5-EBCF-4058-B3B3-05505289953B"><title>Non-window-owning -controls</title> -<p>Non-window-owning controls typically cover only part of a window on -the display, and must be contained in window-owning controls. They are faster -and require fewer resources than window-owning controls.</p> -<p>Examples of non-window-owning controls include:</p> -<ul> -<li><p>command buttons</p></li> -<li><p>edit windows</p></li> -<li><p>labels</p></li> -</ul> -<p>Non-window-owning controls are assigned to window-owning controls by -calling <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/reference/reference-cpp/Control_Environment/CCoeControlClass.html#%3a%3aCCoeControl%3a%3aSetContainerWindowL%28RBackedUpWindow%20%26amp%3b%29" format="application/java-archive"><parmname>CCoeControl::SetContainerWindowL</parmname></xref> when the -control is constructed.</p> -<p>For more information, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/guide/Application-Framework-subsystem-guide/UIControlFrameworkGuide/UIControlFrameworkGuide2/RunTimeControlHierarchy.guide.html#ApplicationFrameworkOverview%2eUIControlFrameworkGuide2%2ehierarchy" format="application/java-archive">The run-time control hierarchy</xref></p> -</section> +<?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-352850A9-227F-45DB-8DCD-C6268954B4ED" xml:lang="en"><title>Window +owning and non-window owning controls</title><prolog><metadata><keywords/></metadata></prolog><conbody> +<section id="GUID-A403D2F8-7ED3-4DE6-92E8-4B16CC646CA6"><title>Window-owning +controls</title> +<p>Window-owning controls have the same size and position as a window in +the display. Each window has a one-to-one relationship with the control that +covers it, and shares its behavior with that control.</p> +<p>Examples of window-owning controls include:</p> +<ul> +<li><p>top-level control in <xref href="GUID-B5DE1C86-2B16-4B22-887F-7079E54A8ED6.dita">Traditional +Symbian architecture</xref></p></li> +<li><p>the subpanes in the status pane</p></li> +<li><p>pop-up windows, when a sense of layering is required</p> +</li> +</ul> +<p>The following code snippet is an example of the second phase construction +of a window-owning control:</p> +<codeblock id="GUID-234E4AC3-2FC8-4AD9-8B72-0FBA478E1D5A" xml:space="preserve">CMyControl::ConstructL() + { + CreateWindowL(); // This makes the control window- + // owning + SetRectL(ClientRect()); // This sets the control’s + // size + ActivateL(); // This must be called before + // the control can be drawn + } +</codeblock> +<p><parmname>ClientRect()</parmname> returns the screen area available +to the application for drawing. This typically does not include the space +that is reserved for the status/control panes.</p> +<p>For more information, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/guide/Application-Framework-subsystem-guide/UIControlFrameworkGuide/UIControlFrameworkGuide2/RunTimeControlHierarchy.guide.html#ApplicationFrameworkOverview%2eUIControlFrameworkGuide2%2ehierarchy" format="application/java-archive">The run-time control hierarchy</xref></p> +</section> +<section id="GUID-13D754E5-EBCF-4058-B3B3-05505289953B"><title>Non-window-owning +controls</title> +<p>Non-window-owning controls typically cover only part of a window on +the display, and must be contained in window-owning controls. They are faster +and require fewer resources than window-owning controls.</p> +<p>Examples of non-window-owning controls include:</p> +<ul> +<li><p>command buttons</p></li> +<li><p>edit windows</p></li> +<li><p>labels</p></li> +</ul> +<p>Non-window-owning controls are assigned to window-owning controls by +calling <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/reference/reference-cpp/Control_Environment/CCoeControlClass.html#%3a%3aCCoeControl%3a%3aSetContainerWindowL%28RBackedUpWindow%20%26amp%3b%29" format="application/java-archive"><parmname>CCoeControl::SetContainerWindowL</parmname></xref> when the +control is constructed.</p> +<p>For more information, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/guide/Application-Framework-subsystem-guide/UIControlFrameworkGuide/UIControlFrameworkGuide2/RunTimeControlHierarchy.guide.html#ApplicationFrameworkOverview%2eUIControlFrameworkGuide2%2ehierarchy" format="application/java-archive">The run-time control hierarchy</xref></p> +</section> </conbody></concept> \ No newline at end of file