Symbian3/PDK/Source/GUID-16950F22-F5DE-4D52-8414-544105BA3200.dita
changeset 1 25a17d01db0c
child 5 f345bda72bc4
equal deleted inserted replaced
0:89d6a7a84779 1:25a17d01db0c
       
     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>