diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-352850A9-227F-45DB-8DCD-C6268954B4ED.dita --- a/Symbian3/SDK/Source/GUID-352850A9-227F-45DB-8DCD-C6268954B4ED.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-352850A9-227F-45DB-8DCD-C6268954B4ED.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,62 +1,62 @@ - - - - - -Window -owning and non-window owning controls -
Window-owning -controls -

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.

-

Examples of window-owning controls include:

-
    -
  • top-level control in Traditional -Symbian platform architecture

  • -
  • the sub-panes in the status pane

  • -
  • pop-up windows, when a sense of layering is required

    -
  • -
-

The following code snippet is an example of the second phase construction -of a window-owning control:

-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 - } - -

CEikAppUi::ClientRect() 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.

-

For more information, see The -run-time control hierarchy

-
-
Non-window-owning -controls -

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.

-

Examples of non-window-owning controls include:

-
    -
  • command buttons

  • -
  • edit windows

  • -
  • labels

  • -
-

Non-window-owning controls are assigned to window-owning controls by -calling CCoeControl::SetContainerWindowL() when the control -is constructed.

-

For more information, see The -run-time control hierarchy

-
+ + + + + +Window +owning and non-window owning controls +
Window-owning +controls +

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.

+

Examples of window-owning controls include:

+
    +
  • top-level control in Traditional +Symbian platform architecture

  • +
  • the sub-panes in the status pane

  • +
  • pop-up windows, when a sense of layering is required

    +
  • +
+

The following code snippet is an example of the second phase construction +of a window-owning control:

+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 + } + +

CEikAppUi::ClientRect() 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.

+

For more information, see The +run-time control hierarchy

+
+
Non-window-owning +controls +

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.

+

Examples of non-window-owning controls include:

+
    +
  • command buttons

  • +
  • edit windows

  • +
  • labels

  • +
+

Non-window-owning controls are assigned to window-owning controls by +calling CCoeControl::SetContainerWindowL() when the control +is constructed.

+

For more information, see The +run-time control hierarchy

+
\ No newline at end of file