Symbian3/SDK/Source/GUID-DAF35D49-9630-4186-A350-E8483693D50D.dita
changeset 0 89d6a7a84779
equal deleted inserted replaced
-1:000000000000 0:89d6a7a84779
       
     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>