Symbian3/PDK/Source/GUID-0822B030-E776-4BD5-B9C9-23D3821BCE1F.dita
changeset 5 f345bda72bc4
parent 1 25a17d01db0c
child 9 59758314f811
--- a/Symbian3/PDK/Source/GUID-0822B030-E776-4BD5-B9C9-23D3821BCE1F.dita	Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-0822B030-E776-4BD5-B9C9-23D3821BCE1F.dita	Tue Mar 30 11:56:28 2010 +0100
@@ -4,10 +4,13 @@
 "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.
+    Nokia Corporation - initial contribution.
 Contributors: 
--->  <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-0822B030-E776-4BD5-B9C9-23D3821BCE1F" xml:lang="en"><title>Selection
-list</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody>
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-0822B030-E776-4BD5-B9C9-23D3821BCE1F" xml:lang="en"><title>Selection
+list</title><prolog><metadata><keywords/></metadata></prolog><conbody>
 <p>A selection list is a common means of displaying and accessing data in
 applications. When a selection list is displayed, the application is typically
 in a permanent state, which means that the user can leave the application,
@@ -33,22 +36,22 @@
 </ul>
 <p>The two types of Selection key actions should not be mixed within one list;
 one or the other should happen for every item in the list.</p>
-<fig id="GUID-63BEF19B-2754-4AE4-BC37-BCBF767319B4">
+<fig id="GUID-010C51B9-5D2A-4DD5-A1DA-67A30CD132FD">
 <title>Select action opens a view</title>
-<image href="GUID-15F35B7F-8CDD-49BA-A015-475C0F6221B8_d0e79947_href.png" scale="40" placement="inline"></image>
+<image href="GUID-B7E55764-C137-4877-9083-63ACEAF30BE5_d0e89180_href.png" placement="inline"/>
 </fig>
-<fig id="GUID-EB8B5041-9CBF-4580-AEBE-69AF79A11198">
+<fig id="GUID-5DD10CF4-6E68-4C81-81D8-1CA45CD674C4">
 <title>Select action performs a command</title>
-<image href="GUID-5365F75F-647F-4225-B63B-35675EBD6038_d0e79955_href.png" scale="40" placement="inline"></image>
+<image href="GUID-06B287CD-C19A-4CAC-8378-5563C552448B_d0e89188_href.png" placement="inline"/>
 </fig>
-<fig id="GUID-4F9A7034-DA55-4577-BB41-8BF0B5885242">
+<fig id="GUID-B8275C0A-50B9-4A48-AC20-8E2B84F23F8B">
 <title>Context sensitive Options menu opened with the Selection key</title>
-<image href="GUID-2CF4F12C-DF30-43EB-BD3D-A6AF8BAB407A_d0e79963_href.png" scale="40" placement="inline"></image>
+<image href="GUID-26778399-0105-413F-A39D-535A3BF5EBE2_d0e89196_href.png" placement="inline"/>
 </fig>
 <p>The keypad functions for selection lists are as follows:</p>
 <table id="GUID-2AF81DA9-8C20-47AE-87DE-8252CC1DAF59"><title>Default key events
 in selection list</title>
-<tgroup cols="2"><colspec colname="col1"></colspec><colspec colname="col2"></colspec>
+<tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/>
 <tbody>
 <row>
 <entry><p>Arrow up / down</p></entry>
@@ -92,12 +95,58 @@
 </tbody>
 </tgroup>
 </table>
-<fig id="GUID-02393CD0-886F-4628-97CE-9FA6DD034634">
+<p/>
+<p>The following table lists the default touch events for selection list:</p>
+<table id="GUID-5B8DA500-4092-4E1A-A035-308C4D352138-GENID-1-10-1-6-1-1-5-1-12-1-1-4-1-2-13"><title>Default touch
+events for Selection list.</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</p></entry>
+<entry><p>No effect</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</p></entry>
+<entry><p>Item is activated.</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</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. Pop-up effect is provided when the pop-up is opened.</p></entry>
+</row>
+<row>
+<entry><p>Touch event combinations, refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging
+and flicking</xref> events.</p></entry>
+<entry><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging
+and flicking</xref> events.</p></entry>
+<entry><p>Tactile: Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging
+and flicking</xref> events.</p></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<fig id="GUID-4149CCA2-D8FE-4393-8D82-A736EF5337C5">
 <title>Selection lists </title>
-<image href="GUID-B0E6F296-1340-4458-B9F6-EDC13BBF20E9_d0e80098_href.png" scale="40" placement="inline"></image>
+<image href="GUID-829C15B1-0769-4E90-935D-4DCA58895E81_d0e89447_href.png" placement="inline"/>
 </fig>
-<section><title>Using selection lists
-in C++ applications</title><p>The API to use for selection lists is the Lists
-API. For implementation information, see Using
-the Lists API.</p></section>
+<section id="GUID-FA4ACC82-0080-429B-A155-433F175138A6"><title>Using
+selection lists in C++ applications</title><p>The API to use for selection
+lists is the <xref format="html" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html" scope="peer">Lists API</xref>. For implementation information,
+see <xref format="htrml" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html#Lists_API_Specification.topic3" scope="peer">Using the Lists API</xref>.</p></section>
 </conbody></concept>
\ No newline at end of file