Symbian3/SDK/Source/GUID-DAF35D49-9630-4186-A350-E8483693D50D.dita
changeset 8 ae94777fff8f
parent 7 51a74ef9ed63
child 13 48780e181b38
--- a/Symbian3/SDK/Source/GUID-DAF35D49-9630-4186-A350-E8483693D50D.dita	Wed Mar 31 11:11:55 2010 +0100
+++ b/Symbian3/SDK/Source/GUID-DAF35D49-9630-4186-A350-E8483693D50D.dita	Fri Jun 11 12:39:03 2010 +0100
@@ -1,135 +1,135 @@
-<?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-DAF35D49-9630-4186-A350-E8483693D50D" xml:lang="en"><title>Hierarchical
-column list</title><prolog><metadata><keywords/></metadata></prolog><conbody>
-<p>Hierarchical column list is used for browsing in one view files and folders
-that are in different levels in the file system. This enables for example
-showing subtitles among the list items, and collapsing and expanding data
-items under it.</p>
-<fig id="GUID-0A22D779-41C5-41DD-884C-AFC7DF192720">
-<title>Hierarchical column list component, where the subtitle "Last week"
-is expanded</title>
-<image href="GUID-2939EEA8-DBC9-4882-B016-9C53166569CD_d0e63329_href.png" placement="inline"/>
-</fig>
-<p>The hierarchical column list can have three different row types:</p>
-<ul>
-<li><p>Subtitle row </p></li>
-<li><p>Core data row </p></li>
-<li><p>Simple data row</p></li>
-</ul>
-<p>Subtitle can have only one type of sub-items, thus both core data and simple
-data items cannot exist under same subtitle. It is recommended, that only
-one type of sub-items would be used in the same view.</p>
-<p>To enable more information in a single row, the core data row can be divided
-into two core data columns. The more important information should be shown
-in the first column due to more space, for example e-mail sender information
-in the first column, and subject in the second column. In landscape there
-can be also third column in use.</p>
-<p><b>General navigation:</b> </p>
-<p>Expanding and collapsing can be done in subtitle rows:</p>
-<ul>
-<li><p>Arrow key: Tabs can be used together with a hierarchical column list,
-and thus arrow keys are used for moving between tabs. If there are no tabs,
-the arrow keys expand subtitle item (Arrow right, the focus is not moved)
-and collapse expanded subtitle item (Arrow left, focus is not moved). </p></li>
-<li><p>The Selection key expands collapsed (or vice versa) subtitle item in
-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>
-<table id="GUID-B5B4FA4B-A296-4CFF-8E6C-3030013798A2"><title>Default touch
-events for hierarchical column list items</title>
-<tgroup cols="3">
-
-<colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/>
-<colspec colname="col3" colwidth="1.19*"/>
-<thead>
-<row>
-<entry valign="top"><p>User action</p></entry>
-<entry valign="top"><p>State change</p></entry>
-<entry valign="top"><p>Feedback</p></entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry><p>Touch down on collapsed subtitle item</p></entry>
-<entry><p>No change</p></entry>
-<entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio
-feedback is provided with touch down event.</p></entry>
-</row>
-<row>
-<entry><p>Touch release on collapsed subtitle item</p></entry>
-<entry><p>Item is expanded. </p><p>If the folder is empty, the only action
-performed is that the icon is changed to expanded folder indication.</p></entry>
-<entry><p>Highlight disappears. </p><p>Tactile: Basic list effect is provided
-with touch release event</p></entry>
-</row>
-<row>
-<entry><p>Touch down on expanded subtitle item</p></entry>
-<entry><p>No change</p></entry>
-<entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio
-feedback is provided with touch down event.</p></entry>
-</row>
-<row>
-<entry><p>Touch release on expanded subtitle item</p></entry>
-<entry><p>Item is collapsed.</p><p>If the folder is empty, the only action
-performed is that the icon is changed to collapsed folder indication.</p></entry>
-<entry><p>Highlight disappears.</p><p>Tactile: Basic list effect is provided
-with touch release event</p></entry>
-</row>
-<row>
-<entry><p>Touch down and hold on subtitle item</p></entry>
-<entry><p>Stylus pop-up menu is opened.</p></entry>
-<entry><p>Highlight is shown. Animation is shown to indicate the opening pop-up. </p><p>Tactile:
-If activates a long touch, then increasing long touch effect is provided with
-hold event and pop-up effect is provided when the pop-up is opened.</p></entry>
-</row>
-<row>
-<entry><p>Touch down on data item</p></entry>
-<entry><p>No change</p></entry>
-<entry><p>Highlight is shown. </p><p>Tactile: Sensitive list effect and audio
-feedback is provided with touch down event.</p></entry>
-</row>
-<row>
-<entry><p>Touch release on data item</p></entry>
-<entry><p>Item is activated. </p><p>Application specific</p></entry>
-<entry><p>Highlight shown. Tactile: Sensitive list effect is provided with
-touch release event.</p></entry>
-</row>
-<row>
-<entry><p>Touch down and hold on data item</p></entry>
-<entry><p>Stylus pop-up menu is opened.</p></entry>
-<entry><p>Highlight is shown. Animation is shown to indicate the opening pop-up. </p><p>Tactile:
-If activates a long touch, then increasing long touch effect is provided with
-hold event and pop-up effect is provided when the pop-up is opened.</p></entry>
-</row>
-<row>
-<entry><p>Touch down on data/subtitle item and move</p></entry>
-<entry><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging
-and flicking</xref> events</p><p>Expand and collapse functions are not done
-while dragging.</p></entry>
-<entry><p>Tactile: Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging
-and flicking</xref> events.</p></entry>
-</row>
-<row>
-<entry><p>Touch down on data/subtitle item and move horizontally</p></entry>
-<entry><p>Inactive</p></entry>
-<entry><p>Tactile: No effect</p></entry>
-</row>
-</tbody>
-</tgroup>
-</table>
-<section id="GUID-4BA0CC1C-D164-4EE0-9178-DE250B7BCB69"><title>Using
-hierarchical column lists in C++ applications</title><p>The API to use for
-hierarchical column lists is the specs/guides/Hierarchical_Lists_API_Specification/Hierarchical_Lists_API_Specification.html.
-For implementation information, see <xref format="html" href="specs/guides/Hierarchical_Lists_API_Specification/Hierarchical_Lists_API_Specification.html#Hierarchical_Lists_API_Specification.topic3" scope="peer">Using the Hierarchical lists API</xref>.</p></section>
+<?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-DAF35D49-9630-4186-A350-E8483693D50D" xml:lang="en"><title>Hierarchical
+column list</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>Hierarchical column list is used for browsing in one view files and folders
+that are in different levels in the file system. This enables for example
+showing subtitles among the list items, and collapsing and expanding data
+items under it.</p>
+<fig id="GUID-0A22D779-41C5-41DD-884C-AFC7DF192720">
+<title>Hierarchical column list component, where the subtitle "Today" and
+"Yesterday" are expanded</title>
+<image href="GUID-2939EEA8-DBC9-4882-B016-9C53166569CD_d0e56908_href.png" placement="inline"/>
+</fig>
+<p>The hierarchical column list can have three different row types:</p>
+<ul>
+<li><p>Subtitle row </p></li>
+<li><p>Core data row </p></li>
+<li><p>Simple data row</p></li>
+</ul>
+<p>Subtitle can have only one type of sub-items, thus both core data and simple
+data items cannot exist under same subtitle. It is recommended, that only
+one type of sub-items would be used in the same view.</p>
+<p>To enable more information in a single row, the core data row can be divided
+into two core data columns. The more important information should be shown
+in the first column due to more space, for example e-mail sender information
+in the first column, and subject in the second column. In landscape there
+can be also third column in use.</p>
+<p><b>General navigation:</b> </p>
+<p>Expanding and collapsing can be done in subtitle rows:</p>
+<ul>
+<li><p>Arrow key: Tabs can be used together with a hierarchical column list,
+and thus arrow keys are used for moving between tabs. If there are no tabs,
+the arrow keys expand subtitle item (Arrow right, the focus is not moved)
+and collapse expanded subtitle item (Arrow left, focus is not moved). </p></li>
+<li><p>The Selection key expands collapsed (or vice versa) subtitle item in
+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>
+<table id="GUID-B5B4FA4B-A296-4CFF-8E6C-3030013798A2"><title>Default touch
+events for hierarchical column list items</title>
+<tgroup cols="3">
+
+<colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/>
+<colspec colname="col3" colwidth="1.19*"/>
+<thead>
+<row>
+<entry valign="top"><p>User action</p></entry>
+<entry valign="top"><p>State change</p></entry>
+<entry valign="top"><p>Feedback</p></entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p>Touch down on collapsed subtitle item</p></entry>
+<entry><p>No change</p></entry>
+<entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio
+feedback is provided with touch down event.</p></entry>
+</row>
+<row>
+<entry><p>Touch release on collapsed subtitle item</p></entry>
+<entry><p>Item is expanded. </p><p>If the folder is empty, the only action
+performed is that the icon is changed to expanded folder indication.</p></entry>
+<entry><p>Highlight disappears. </p><p>Tactile: Basic list effect is provided
+with touch release event</p></entry>
+</row>
+<row>
+<entry><p>Touch down on expanded subtitle item</p></entry>
+<entry><p>No change</p></entry>
+<entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio
+feedback is provided with touch down event.</p></entry>
+</row>
+<row>
+<entry><p>Touch release on expanded subtitle item</p></entry>
+<entry><p>Item is collapsed.</p><p>If the folder is empty, the only action
+performed is that the icon is changed to collapsed folder indication.</p></entry>
+<entry><p>Highlight disappears.</p><p>Tactile: Basic list effect is provided
+with touch release event</p></entry>
+</row>
+<row>
+<entry><p>Touch down and hold on subtitle item</p></entry>
+<entry><p>Stylus pop-up menu is opened.</p></entry>
+<entry><p>Highlight is shown. Animation is shown to indicate the opening pop-up. </p><p>Tactile:
+If activates a long touch, then increasing long touch effect is provided with
+hold event and pop-up effect is provided when the pop-up is opened.</p></entry>
+</row>
+<row>
+<entry><p>Touch down on data item</p></entry>
+<entry><p>No change</p></entry>
+<entry><p>Highlight is shown. </p><p>Tactile: Sensitive list effect and audio
+feedback is provided with touch down event.</p></entry>
+</row>
+<row>
+<entry><p>Touch release on data item</p></entry>
+<entry><p>Item is activated. </p><p>Application specific</p></entry>
+<entry><p>Highlight shown. Tactile: Sensitive list effect is provided with
+touch release event.</p></entry>
+</row>
+<row>
+<entry><p>Touch down and hold on data item</p></entry>
+<entry><p>Stylus pop-up menu is opened.</p></entry>
+<entry><p>Highlight is shown. Animation is shown to indicate the opening pop-up. </p><p>Tactile:
+If activates a long touch, then increasing long touch effect is provided with
+hold event and pop-up effect is provided when the pop-up is opened.</p></entry>
+</row>
+<row>
+<entry><p>Touch down on data/subtitle item and move</p></entry>
+<entry><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging
+and flicking</xref> events</p><p>Expand and collapse functions are not done
+while dragging.</p></entry>
+<entry><p>Tactile: Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging
+and flicking</xref> events.</p></entry>
+</row>
+<row>
+<entry><p>Touch down on data/subtitle item and move horizontally</p></entry>
+<entry><p>Inactive</p></entry>
+<entry><p>Tactile: No effect</p></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<section id="GUID-4BA0CC1C-D164-4EE0-9178-DE250B7BCB69"><title>Using
+hierarchical column lists in applications</title><p>The API to use for hierarchical
+column lists is the <xref format="html" href="specs/guides/Hierarchical_Lists_API_Specification/Hierarchical_Lists_API_Specification.html" scope="peer">Hierarchical lists API</xref>. For implementation information,
+see <xref format="html" href="specs/guides/Hierarchical_Lists_API_Specification/Hierarchical_Lists_API_Specification.html#Hierarchical_Lists_API_Specification.topic3" scope="peer">Using the Hierarchical lists API</xref>.</p></section>
 </conbody></concept>
\ No newline at end of file