|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-659E2A30-C2E0-4E5A-AA9F-50EBEC7E9579" xml:lang="en"><title>Windows |
|
13 and panes</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>The display layouts are hierarchically organized. The layouts are built |
|
15 using components called windows and panes.</p> |
|
16 <table id="GUID-4E9DAC1B-1835-4838-ADBA-34EA35E77DF9"><title>Windows and panes</title> |
|
17 <tgroup cols="2"><colspec colname="col1" colwidth="0.34*"/><colspec colname="col2" colwidth="1.66*"/> |
|
18 <thead> |
|
19 <row> |
|
20 <entry>Window / Pane</entry> |
|
21 <entry><p>Description</p></entry> |
|
22 </row> |
|
23 </thead> |
|
24 <tbody> |
|
25 <row> |
|
26 <entry><p>Screen</p></entry> |
|
27 <entry><p>The screen is the topmost display component, corresponding to the |
|
28 entire pixel area of the physical screen.</p></entry> |
|
29 </row> |
|
30 <row> |
|
31 <entry><p>Window</p></entry> |
|
32 <entry><p>A window is a component that has no parent except the screen. Typically, |
|
33 a window fills up the entire screen, but there are also smaller (temporary) |
|
34 windows that take up only a part of the screen, leaving other parts of the |
|
35 screen visible around themselves. Each application runs in a window of its |
|
36 own. Applications can also use other temporary windows.</p></entry> |
|
37 </row> |
|
38 <row> |
|
39 <entry><p>Pane</p></entry> |
|
40 <entry><p>A pane is a subcomponent of a window. A window may contain several |
|
41 panes, and each pane may contain further sub-panes and so on. A bottom level |
|
42 component that cannot have a sub-component can be called an element.</p></entry> |
|
43 </row> |
|
44 <row> |
|
45 <entry><p>Application window</p></entry> |
|
46 <entry><p>An application window is a main window filling up the entire screen. |
|
47 It is usually not used directly for display, but just as a parent for the |
|
48 various panes. A typical application window is divided into the following |
|
49 panes:<ul> |
|
50 <li><p/>Status pane</li> |
|
51 <li><p/>Main pane</li> |
|
52 <li><p/>Control pane</li> |
|
53 </ul>See <xref href="GUID-08B878D0-C0DA-46CC-ACC2-E576E5A3D937.dita">Main pane</xref> , <xref href="GUID-771AF721-E2D7-41C8-BF97-5BD30D1A28AD.dita">Status pane</xref> and <xref href="GUID-8B137691-7C9E-4085-BFFE-4CFE4A64A091.dita">Control pane</xref> for more |
|
54 detailed descriptions on each of these panes.</p></entry> |
|
55 </row> |
|
56 <row> |
|
57 <entry><p>Pop-up window</p></entry> |
|
58 <entry><p>A pop-up window must not fill the entire screen; the pop-up window |
|
59 has a frame, and typically the underlying application is partly visible around |
|
60 the pop-up window. Pop-up windows are typically used in temporary states. |
|
61 Back stepping should not usually lead to a pop-up window. Detailed information |
|
62 on the various pop-up windows can be found in <xref href="GUID-2922758C-37A4-436E-B0F3-358944F84E2A.dita">Pop-up |
|
63 windows</xref>.</p></entry> |
|
64 </row> |
|
65 </tbody> |
|
66 </tgroup> |
|
67 </table> |
|
68 <fig id="GUID-257C16FF-DE8E-4942-BB99-B013D7E1AD28"> |
|
69 <title>Panes</title> |
|
70 <image href="GUID-72262200-B940-4D0C-8FA0-6628E9894E8F_d0e72000_href.png" placement="inline"/> |
|
71 </fig> |
|
72 <section id="GUID-EA67A1C1-D843-48BF-BC32-BB8225B65220"><title>Using |
|
73 windows and panes in C++ applications</title><p>Windows and panes use the |
|
74 Symbian application and UI frameworks. For implementation information, see <xref href="GUID-29486886-CB54-4A83-AD6D-70F971A86DFC.dita">Application and UI framework |
|
75 implementation considerations</xref>.</p></section> |
|
76 </conbody></concept> |