|
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 --> <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-DAF35D49-9630-4186-A350-E8483693D50D" xml:lang="en"><title>Hierarchical |
|
10 column list</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody> |
|
11 <p>Hierarchical column list is used for browsing in one view files and folders |
|
12 that are in different levels in the file system. This enables for example |
|
13 showing subtitles among the list items, and collapsing and expanding data |
|
14 items under it.</p> |
|
15 <fig id="GUID-0A22D779-41C5-41DD-884C-AFC7DF192720"> |
|
16 <title>Hierarchical column list component, where the subtitle "Yesterday" |
|
17 is expanded</title> |
|
18 <image href="GUID-573420CD-E8E0-4E98-B3E2-1388F4B1137D_d0e55804_href.png" scale="40" placement="inline"></image> |
|
19 </fig> |
|
20 <p>The hierarchical column list can have three different row types:</p> |
|
21 <ul> |
|
22 <li><p>Subtitle row </p></li> |
|
23 <li><p>Core data row </p></li> |
|
24 <li><p>Simple data row</p></li> |
|
25 </ul> |
|
26 <p>Subtitle can have only one type of subitems, thus both core data and simple |
|
27 data items cannot exist under same subtitle. It is recommended, that only |
|
28 one type of subitems would be used in the same view.</p> |
|
29 <p>To enable more information in a single row, the core data row can be divided |
|
30 into two core data columns. The more important information should be shown |
|
31 in the first column due to more space, for example e-mail sender information |
|
32 in the first column, and subject in the second column. In landscape there |
|
33 can be also third column in use.</p> |
|
34 <p><b>General navigation:</b> </p> |
|
35 <p>Expanding and collapsing can be done in subtitle rows:</p> |
|
36 <ul> |
|
37 <li><p>Arrow key: Tabs can be used together with a hierarchical column list, |
|
38 and thus arrow keys are used for moving between tabs. If there are no tabs, |
|
39 the arrow keys expand subtitle item (Arrow right, the focus is not moved) |
|
40 and collapse expanded subtitle item (Arrow left, focus is not moved). </p></li> |
|
41 <li><p>The Selection key expands collapsed (or vice versa) subtitle item in |
|
42 focus. </p></li> |
|
43 <li><p>Commands for expanding, collapsing and opening folders or files are |
|
44 also available in the <b>Options</b> menu.</p></li> |
|
45 </ul> |
|
46 <section><title>Using hierarchical column |
|
47 lists in C++ applications</title><p>The API to use for hierarchical column |
|
48 lists is the Hierarchical |
|
49 lists API. For implementation information, see Using |
|
50 the Hierarchical lists API.</p></section> |
|
51 </conbody></concept> |