|
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 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-DAF35D49-9630-4186-A350-E8483693D50D" xml:lang="en"><title>Hierarchical |
|
13 column list</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>Hierarchical column list is used for browsing in one view files and folders |
|
15 that are in different levels in the file system. This enables for example |
|
16 showing subtitles among the list items, and collapsing and expanding data |
|
17 items under it.</p> |
|
18 <fig id="GUID-0A22D779-41C5-41DD-884C-AFC7DF192720"> |
|
19 <title>Hierarchical column list component, where the subtitle "Last week" |
|
20 is expanded</title> |
|
21 <image href="GUID-2939EEA8-DBC9-4882-B016-9C53166569CD_d0e63329_href.png" placement="inline"/> |
|
22 </fig> |
|
23 <p>The hierarchical column list can have three different row types:</p> |
|
24 <ul> |
|
25 <li><p>Subtitle row </p></li> |
|
26 <li><p>Core data row </p></li> |
|
27 <li><p>Simple data row</p></li> |
|
28 </ul> |
|
29 <p>Subtitle can have only one type of sub-items, thus both core data and simple |
|
30 data items cannot exist under same subtitle. It is recommended, that only |
|
31 one type of sub-items would be used in the same view.</p> |
|
32 <p>To enable more information in a single row, the core data row can be divided |
|
33 into two core data columns. The more important information should be shown |
|
34 in the first column due to more space, for example e-mail sender information |
|
35 in the first column, and subject in the second column. In landscape there |
|
36 can be also third column in use.</p> |
|
37 <p><b>General navigation:</b> </p> |
|
38 <p>Expanding and collapsing can be done in subtitle rows:</p> |
|
39 <ul> |
|
40 <li><p>Arrow key: Tabs can be used together with a hierarchical column list, |
|
41 and thus arrow keys are used for moving between tabs. If there are no tabs, |
|
42 the arrow keys expand subtitle item (Arrow right, the focus is not moved) |
|
43 and collapse expanded subtitle item (Arrow left, focus is not moved). </p></li> |
|
44 <li><p>The Selection key expands collapsed (or vice versa) subtitle item in |
|
45 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 <table id="GUID-B5B4FA4B-A296-4CFF-8E6C-3030013798A2"><title>Default touch |
|
50 events for hierarchical column list items</title> |
|
51 <tgroup cols="3"> |
|
52 |
|
53 <colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/> |
|
54 <colspec colname="col3" colwidth="1.19*"/> |
|
55 <thead> |
|
56 <row> |
|
57 <entry valign="top"><p>User action</p></entry> |
|
58 <entry valign="top"><p>State change</p></entry> |
|
59 <entry valign="top"><p>Feedback</p></entry> |
|
60 </row> |
|
61 </thead> |
|
62 <tbody> |
|
63 <row> |
|
64 <entry><p>Touch down on collapsed subtitle item</p></entry> |
|
65 <entry><p>No change</p></entry> |
|
66 <entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio |
|
67 feedback is provided with touch down event.</p></entry> |
|
68 </row> |
|
69 <row> |
|
70 <entry><p>Touch release on collapsed subtitle item</p></entry> |
|
71 <entry><p>Item is expanded. </p><p>If the folder is empty, the only action |
|
72 performed is that the icon is changed to expanded folder indication.</p></entry> |
|
73 <entry><p>Highlight disappears. </p><p>Tactile: Basic list effect is provided |
|
74 with touch release event</p></entry> |
|
75 </row> |
|
76 <row> |
|
77 <entry><p>Touch down on expanded subtitle item</p></entry> |
|
78 <entry><p>No change</p></entry> |
|
79 <entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio |
|
80 feedback is provided with touch down event.</p></entry> |
|
81 </row> |
|
82 <row> |
|
83 <entry><p>Touch release on expanded subtitle item</p></entry> |
|
84 <entry><p>Item is collapsed.</p><p>If the folder is empty, the only action |
|
85 performed is that the icon is changed to collapsed folder indication.</p></entry> |
|
86 <entry><p>Highlight disappears.</p><p>Tactile: Basic list effect is provided |
|
87 with touch release event</p></entry> |
|
88 </row> |
|
89 <row> |
|
90 <entry><p>Touch down and hold on subtitle item</p></entry> |
|
91 <entry><p>Stylus pop-up menu is opened.</p></entry> |
|
92 <entry><p>Highlight is shown. Animation is shown to indicate the opening pop-up. </p><p>Tactile: |
|
93 If activates a long touch, then increasing long touch effect is provided with |
|
94 hold event and pop-up effect is provided when the pop-up is opened.</p></entry> |
|
95 </row> |
|
96 <row> |
|
97 <entry><p>Touch down on data item</p></entry> |
|
98 <entry><p>No change</p></entry> |
|
99 <entry><p>Highlight is shown. </p><p>Tactile: Sensitive list effect and audio |
|
100 feedback is provided with touch down event.</p></entry> |
|
101 </row> |
|
102 <row> |
|
103 <entry><p>Touch release on data item</p></entry> |
|
104 <entry><p>Item is activated. </p><p>Application specific</p></entry> |
|
105 <entry><p>Highlight shown. Tactile: Sensitive list effect is provided with |
|
106 touch release event.</p></entry> |
|
107 </row> |
|
108 <row> |
|
109 <entry><p>Touch down and hold on data item</p></entry> |
|
110 <entry><p>Stylus pop-up menu is opened.</p></entry> |
|
111 <entry><p>Highlight is shown. Animation is shown to indicate the opening pop-up. </p><p>Tactile: |
|
112 If activates a long touch, then increasing long touch effect is provided with |
|
113 hold event and pop-up effect is provided when the pop-up is opened.</p></entry> |
|
114 </row> |
|
115 <row> |
|
116 <entry><p>Touch down on data/subtitle item and move</p></entry> |
|
117 <entry><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
118 and flicking</xref> events</p><p>Expand and collapse functions are not done |
|
119 while dragging.</p></entry> |
|
120 <entry><p>Tactile: Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
121 and flicking</xref> events.</p></entry> |
|
122 </row> |
|
123 <row> |
|
124 <entry><p>Touch down on data/subtitle item and move horizontally</p></entry> |
|
125 <entry><p>Inactive</p></entry> |
|
126 <entry><p>Tactile: No effect</p></entry> |
|
127 </row> |
|
128 </tbody> |
|
129 </tgroup> |
|
130 </table> |
|
131 <section id="GUID-4BA0CC1C-D164-4EE0-9178-DE250B7BCB69"><title>Using |
|
132 hierarchical column lists in C++ applications</title><p>The API to use for |
|
133 hierarchical column lists is the specs/guides/Hierarchical_Lists_API_Specification/Hierarchical_Lists_API_Specification.html. |
|
134 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> |
|
135 </conbody></concept> |