|
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-CB548959-A1D6-4585-B8E3-B09E37E0CB43" xml:lang="en"><title>List |
|
13 layouts</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>List items can in general be more complex (contain more elements) than |
|
15 grid items. Certain layout rules apply to all lists:</p> |
|
16 <ul> |
|
17 <li><p>All items in a list have equal height on the screen (forms do not follow |
|
18 this rule in the Edit state, see <xref href="GUID-1AA32C40-CDE0-4627-A634-7C07BB1ED67B.dita">Forms</xref>). </p></li> |
|
19 <li><p>The column structure of all items in a list must be similar. It is |
|
20 not possible to combine e.g. single-column items to a three-column item list |
|
21 (however, it is possible to use some different item types having the same |
|
22 general appearance), see <xref href="GUID-F95A7D74-FD5C-40D2-BF4F-2F75443CAE51.dita">Column |
|
23 structure of lists</xref> for columns. </p></li> |
|
24 <li><p>Partial items are not visible: when the list/grid pane area does not |
|
25 exactly correspond to an integer number of items, the remaining area outside |
|
26 the last fully visible item appears empty, displaying the background of the |
|
27 particular pane.</p></li> |
|
28 </ul> |
|
29 <p>In landscape layout, all two row lists can be stretched to be displayed |
|
30 in one row. This enables displaying more items in the list. In list stretching, |
|
31 the second row is moved next to the first row. List stretching is ON by default, |
|
32 but application can decide to disable it.</p> |
|
33 <fig id="GUID-425291FD-35BB-4145-A509-9BBC5B18022C"> |
|
34 <title>Two row list in stretched mode in landscape layout</title> |
|
35 <image href="GUID-D2263F64-2582-473A-B939-ACEBF8E974BF_d0e59088_href.png" placement="inline"/> |
|
36 </fig> |
|
37 <section id="GUID-A3F9AF92-392F-4EF6-8CFB-5B8CF0AA5210"><title>Using |
|
38 list layouts in C++ applications</title><p>The API to use for lists is the <xref format="html" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html" scope="peer">Lists API</xref>. For implementation information, see <xref format="htrml" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html#Lists_API_Specification.topic3" scope="peer">Using the Lists API</xref>.</p><p>For grids, the APIs to use |
|
39 are the <xref format="html" href="specs/guides/Grids_API_Specification/Grids_API_Specification.html" scope="peer">Grids API</xref> and the <xref format="html" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html" scope="peer">Lists API</xref>. For implementation information, see <xref format="html" href="specs/guides/Grids_API_Specification/Grids_API_Specification.html#Grids_API_Specification.topic3" scope="peer">Using the Grids API</xref> and <xref format="htrml" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html#Lists_API_Specification.topic3" scope="peer">Using the Lists API</xref>.</p></section> |
|
40 </conbody></concept> |