--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-16950F22-F5DE-4D52-8414-544105BA3200.dita	Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+	Nokia Corporation - initial contribution.
+Contributors: 
+-->  <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-16950F22-F5DE-4D52-8414-544105BA3200" xml:lang="en"><title>Hierarchical
+list</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody>
+<p>The hierarchical list component (a "tree list") is available for use in
+dialogs that deal with moving items to and from (or copying them) from one
+folder to another. The main use situation for the component is the File Manager
+folder and file browsing, when the actual data is being showed in the same
+view. The hierarchical list component allows users to browse through their
+folder content by having a list and its content available simultaneously:
+the user can simply expand a listed item (folder) to show its content.</p>
+<p>Unlike the other Symbian list types, the hierarchical list
+component is not structured on the A   D column structure. Visually, the hierarchical
+levels are connected with vertical lines (see the figure below), and the folders
+in each hierarchy level are shown before files on that same level. Scroll
+bars function as usual (vertical bar is always present, horizontal bar is
+available when necessary), and the list does not loop by default, although
+it is possible to enable looping. Marquee scrolling is supported, but if not
+used, the names of folders and files are truncated where necessary. The height
+and the vertical distribution of the folder/file texts on the list is the
+same as in normal lists. Hierarchical lists can be used both in the main pane
+and as pop-ups.</p>
+<fig id="GUID-5CC170B7-72AA-422E-8C44-AFB135C596D6">
+<title>Hierarchical list component</title>
+<image href="GUID-341CE215-056C-45B6-ABE2-C75442605147_d0e80725_href.png" scale="40" placement="inline"></image>
+</fig>
+<p>Owing to the need for horizontal scrolling, it is not possible to use tabs
+in the Navi pane. Typically the hierarchical list component is capable of
+showing three hierarchy levels in portrait orientation, but this may vary
+according to the display sizes and resolutions as well as the display orientation.
+The order of folders (sorting order) on each level is defined by the application.</p>
+<p><b>General navigation:</b></p>
+<ul>
+<li><p>Arrow keys either expand collapsed folders (Arrow right, the focus
+does not move yet), collapse expanded folders (Arrow left: one press to move
+the focus onto the parent folder when there is one, second press to collapse
+the contents), or move the focus into the direction of scrolling. </p></li>
+<li><p>The Selection key expands collapsed (or vice versa) folders or opens
+files under focus. </p></li>
+<li><p>Commands for expanding, collapsing and opening folders or files are
+also available in the <b>Options</b> menu.</p></li>
+</ul>
+<section id="GUID-E507585F-2B77-49BC-B982-76E143E7BF2A"><title>Using
+hierarchical lists in C++ applications</title><p>The API to use for hierarchical
+lists is the Hierarchical
+lists API. For implementation information, see Using
+the Hierarchical lists API.</p></section>
+</conbody></concept>
\ No newline at end of file