18 are relative to its own parent control window position. Top-level window-owning |
18 are relative to its own parent control window position. Top-level window-owning |
19 controls are displayed using a position relative to the display. In other |
19 controls are displayed using a position relative to the display. In other |
20 words, it uses the physical coordinates of the display.</p> |
20 words, it uses the physical coordinates of the display.</p> |
21 <p>The following figure illustrates this relationship.</p> |
21 <p>The following figure illustrates this relationship.</p> |
22 <fig id="GUID-9D373EB7-096D-4C84-8060-577F33D462EE"><title>Relative positions of three controls where the top-level parent owns |
22 <fig id="GUID-9D373EB7-096D-4C84-8060-577F33D462EE"><title>Relative positions of three controls where the top-level parent owns |
23 the window</title><image href="GUID-61C340D0-9058-45C2-9A90-4AB8E0612872_d0e46589_href.png"/></fig> |
23 the window</title><image href="GUID-61C340D0-9058-45C2-9A90-4AB8E0612872_d0e41032_href.png"/></fig> |
24 <p>Consider three controls, <b>A</b>, <b>B</b>, and <b>C</b> (shown in |
24 <p>Consider three controls, <b>A</b>, <b>B</b>, and <b>C</b> (shown in |
25 the figure above):</p> |
25 the figure above):</p> |
26 <ul> |
26 <ul> |
27 <li><p><b>A</b> is a top-level control and owns a window</p> |
27 <li><p><b>A</b> is a top-level control and owns a window</p> |
28 </li> |
28 </li> |
40 </ul> |
40 </ul> |
41 <p>However, if <b>B</b> is a child control of <b>A</b> but also has a window |
41 <p>However, if <b>B</b> is a child control of <b>A</b> but also has a window |
42 of its own, it is a child window of <b>A</b>'s window (as shown in the following |
42 of its own, it is a child window of <b>A</b>'s window (as shown in the following |
43 figure). Then if <b>C</b> is a child of <b>B</b> and sets its window by calling <parmname>CCoeControl::SetContainerWindowL(B)</parmname>, |
43 figure). Then if <b>C</b> is a child of <b>B</b> and sets its window by calling <parmname>CCoeControl::SetContainerWindowL(B)</parmname>, |
44 the position of <b>C</b> (p') is relative to <b>B</b>'s window.</p> |
44 the position of <b>C</b> (p') is relative to <b>B</b>'s window.</p> |
45 <fig id="GUID-5884BDB6-6ED0-4EF6-A64F-3EEAAAEE2FF0"><title>Relative positions of three controls where a child owns a window</title><image href="GUID-3A506E2A-2999-458B-BBA2-DCC4D2EA5492_d0e46692_href.png"/></fig> |
45 <fig id="GUID-5884BDB6-6ED0-4EF6-A64F-3EEAAAEE2FF0"><title>Relative positions of three controls where a child owns a window</title><image href="GUID-3A506E2A-2999-458B-BBA2-DCC4D2EA5492_d0e41135_href.png"/></fig> |
46 <p>As the example illustrates, a control position depends on the window |
46 <p>As the example illustrates, a control position depends on the window |
47 in which it is drawn. Therefore, you need to know the drawing window for each |
47 in which it is drawn. Therefore, you need to know the drawing window for each |
48 control. It is an important issue when designing a UI layout. There are some |
48 control. It is an important issue when designing a UI layout. There are some |
49 common controls that optionally may have their own window, such as menus, |
49 common controls that optionally may have their own window, such as menus, |
50 dialogs, and scroll bars. The application framework handles drawing these |
50 dialogs, and scroll bars. The application framework handles drawing these |