|
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-16950F22-F5DE-4D52-8414-544105BA3200" xml:lang="en"><title>Hierarchical |
|
10 list</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody> |
|
11 <p>The hierarchical list component (a "tree list") is available for use in |
|
12 dialogs that deal with moving items to and from (or copying them) from one |
|
13 folder to another. The main use situation for the component is the File Manager |
|
14 folder and file browsing, when the actual data is being showed in the same |
|
15 view. The hierarchical list component allows users to browse through their |
|
16 folder content by having a list and its content available simultaneously: |
|
17 the user can simply expand a listed item (folder) to show its content.</p> |
|
18 <p>Unlike the other Symbian list types, the hierarchical list |
|
19 component is not structured on the A D column structure. Visually, the hierarchical |
|
20 levels are connected with vertical lines (see the figure below), and the folders |
|
21 in each hierarchy level are shown before files on that same level. Scroll |
|
22 bars function as usual (vertical bar is always present, horizontal bar is |
|
23 available when necessary), and the list does not loop by default, although |
|
24 it is possible to enable looping. Marquee scrolling is supported, but if not |
|
25 used, the names of folders and files are truncated where necessary. The height |
|
26 and the vertical distribution of the folder/file texts on the list is the |
|
27 same as in normal lists. Hierarchical lists can be used both in the main pane |
|
28 and as pop-ups.</p> |
|
29 <fig id="GUID-5CC170B7-72AA-422E-8C44-AFB135C596D6"> |
|
30 <title>Hierarchical list component</title> |
|
31 <image href="GUID-341CE215-056C-45B6-ABE2-C75442605147_d0e80725_href.png" scale="40" placement="inline"></image> |
|
32 </fig> |
|
33 <p>Owing to the need for horizontal scrolling, it is not possible to use tabs |
|
34 in the Navi pane. Typically the hierarchical list component is capable of |
|
35 showing three hierarchy levels in portrait orientation, but this may vary |
|
36 according to the display sizes and resolutions as well as the display orientation. |
|
37 The order of folders (sorting order) on each level is defined by the application.</p> |
|
38 <p><b>General navigation:</b></p> |
|
39 <ul> |
|
40 <li><p>Arrow keys either expand collapsed folders (Arrow right, the focus |
|
41 does not move yet), collapse expanded folders (Arrow left: one press to move |
|
42 the focus onto the parent folder when there is one, second press to collapse |
|
43 the contents), or move the focus into the direction of scrolling. </p></li> |
|
44 <li><p>The Selection key expands collapsed (or vice versa) folders or opens |
|
45 files under focus. </p></li> |
|
46 <li><p>Commands for expanding, collapsing and opening folders or files are |
|
47 also available in the <b>Options</b> menu.</p></li> |
|
48 </ul> |
|
49 <section id="GUID-E507585F-2B77-49BC-B982-76E143E7BF2A"><title>Using |
|
50 hierarchical lists in C++ applications</title><p>The API to use for hierarchical |
|
51 lists is the Hierarchical |
|
52 lists API. For implementation information, see Using |
|
53 the Hierarchical lists API.</p></section> |
|
54 </conbody></concept> |