Symbian3/PDK/Source/GUID-76FD2A71-E8A3-4C82-9704-3F7F6AD4DFD8.dita
changeset 5 f345bda72bc4
parent 1 25a17d01db0c
child 9 59758314f811
--- a/Symbian3/PDK/Source/GUID-76FD2A71-E8A3-4C82-9704-3F7F6AD4DFD8.dita	Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-76FD2A71-E8A3-4C82-9704-3F7F6AD4DFD8.dita	Tue Mar 30 11:56:28 2010 +0100
@@ -4,20 +4,24 @@
 "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-76FD2A71-E8A3-4C82-9704-3F7F6AD4DFD8" xml:lang="en"><title>Navi pane</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody>
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-76FD2A71-E8A3-4C82-9704-3F7F6AD4DFD8" xml:lang="en"><title>Navi
+pane</title><prolog><metadata><keywords/></metadata></prolog><conbody>
 <p>The principal uses of the Navi pane are to display information about the
 current state and view, and to help the user to navigate in the application.</p>
-<fig id="GUID-1F8587D9-3439-4AD6-8687-3B4D9ADF27AB">
+<fig id="GUID-3E3F8A70-C0EB-4B17-AB6D-7374FBF8B453">
 <title>Navi pane</title>
-<image href="GUID-876EE000-01B7-4457-AE9C-CE56E48CFF11_d0e78276_href.png" scale="40" placement="inline"></image>
+<image href="GUID-EDBCCC26-BA4D-4318-9F0D-62272FA97BBF_d0e100338_href.png" placement="inline"/>
 </fig>
 <p>Depending on the context, the Navi pane contains elements presented in
 the following table.</p>
 <table id="GUID-8F674003-C512-4E42-BB7E-85A55F93E3BB"><title>Possible Navi
 pane content</title>
-<tgroup cols="2"><colspec colname="col1"></colspec><colspec colname="col2"></colspec>
+<tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/>
 <thead>
 <row>
 <entry>Component</entry>
@@ -26,7 +30,7 @@
 </thead>
 <tbody>
 <row>
-<entry><p>Tabs</p><fig id="GUID-2CBA76C9-3918-40C7-889B-BC5181B34955"></fig></entry>
+<entry><p>Tabs</p><fig id="GUID-2CBA76C9-3918-40C7-889B-BC5181B34955"/></entry>
 <entry><p>Tabs are used to view parallel data views alternatively. Arrow indicators
 are shown at both ends of the pane when there are further tabs to scroll in
 the corresponding direction. Each tab has either a graphic or a text (or both)
@@ -39,12 +43,13 @@
 </ul>The currently active tab is highlighted.</p><p>More than four tabs can
 exist simultaneously. They can be scrolled horizontally. However, as a design
 guideline, the number of tabs should be kept small (the maximum of six tabs
-is recommended), and the number should not be dynamic. See <xref href="GUID-72DE3EB1-1AF5-4157-8B99-A1C7143DAD2C.dita"></xref> for
+is recommended), and the number should not be dynamic. See <xref href="GUID-72DE3EB1-1AF5-4157-8B99-A1C7143DAD2C.dita">Navigation
+using tabs</xref> for
 a description of the effect of tabs on the navigation within an application.</p></entry>
 </row>
 <row>
 <entry><p>Navigation text (icon+text)</p><fig id="GUID-B2C30B15-0343-4430-8535-05C8BAAB1B7B">
-<image href="GUID-6FE79448-5052-46F9-A74E-A128CB367697_d0e78352_href.png" scale="30" placement="inline"></image>
+<image href="GUID-6FE79448-5052-46F9-A74E-A128CB367697_d0e100414_href.png" scale="30" placement="inline"/>
 </fig></entry>
 <entry><p>Navigation text is displayed in the <uicontrol>Navi pane</uicontrol> when
 similar items can be browsed by scrolling horizontally, such as dates in Calendar.
@@ -52,7 +57,7 @@
 </row>
 <row>
 <entry><p>Indicators</p><fig id="GUID-89499CD6-C3C5-4BD5-964A-02ADD8A30116">
-<image href="GUID-03A3E872-8183-4F56-976E-A6AF435742C6_d0e78370_href.png" scale="30" placement="inline"></image>
+<image href="GUID-03A3E872-8183-4F56-976E-A6AF435742C6_d0e100432_href.png" scale="30" placement="inline"/>
 </fig></entry>
 <entry><p>In editors, the <uicontrol>Navi pane</uicontrol> contains editing
 indicators. See <xref href="GUID-BA8806CC-BE7C-4927-ACF6-DA0CB6E96AAA.dita">Indicators</xref> for
@@ -60,7 +65,7 @@
 </row>
 <row>
 <entry><p>Folder structure indication</p><fig id="GUID-274C1478-A141-4705-A6BF-E99703FE714D">
-<image href="GUID-257212F5-A414-4F17-A786-DB3168218139_d0e78393_href.png" scale="30" placement="inline"></image>
+<image href="GUID-257212F5-A414-4F17-A786-DB3168218139_d0e100455_href.png" scale="30" placement="inline"/>
 </fig></entry>
 <entry><p>Opened subfolders are indicated in the <uicontrol>Navi pane</uicontrol>.</p></entry>
 </row>
@@ -70,22 +75,64 @@
 pane</uicontrol> content can be designed specifically for an application.</p></entry>
 </row>
 <row>
+
 <entry><p>Empty pane</p><fig id="GUID-85A80F31-F9ED-4ECE-BAF0-5A2083CE578A">
-<image href="GUID-E64A8D76-28AD-4F75-9E92-3290488F85D9_d0e78425_href.png" scale="30" placement="inline"></image>
+<image href="GUID-E64A8D76-28AD-4F75-9E92-3290488F85D9_d0e100489_href.png" scale="30" placement="inline"/>
 </fig></entry>
 <entry><p>The <uicontrol>Navi pane</uicontrol> can be empty.</p></entry>
 </row>
 </tbody>
 </tgroup>
 </table>
-<section><title>Using the navi pane in
-C++ applications</title><p>The API to use for the Navi pane is the Navigation pane API. If you use tabs in the Navi pane, the API for
-controlling the tabs is the Tabs
-API.</p><p>For the indicators in the Navi pane, use the Indicators API.</p><p>For implementation information on the Navi pane,
-see Using
-the Navigation pane API. For implementation information on tabs, see Using
-the Tabs API.</p><p>The class <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classMAknNaviDecoratorObserver.html" format="application/java-archive"><codeph>MAknNaviDecoratorObserver</codeph></xref> provides touch support for the tab arrows in the Navi pane. To set
-the observer, use the method <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknNavigationDecorator.html#660e9ba08945b213aba477b7863873cc" format="application/java-archive"><codeph>CAknNavigationDecorator::SetNaviDecoratorObserver()</codeph></xref>.</p><p>To
-create a tab group in the Navi pane, use the method <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknNavigationControlContainer.html#93d16329080f21bcd8428db61f177abc" format="application/java-archive"><codeph>CreateTabGroupL()</codeph></xref> in the class <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknNavigationControlContainer.html" format="application/java-archive"><codeph>CAknNavigationControlContainer</codeph></xref>. This is a factory
+<p/>
+<table id="GUID-D5CFA14A-79F4-4E9C-A051-6588C7DDAC59"><title>Default touch
+events for ungrouped soft notification</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 navigation text or navigation arrow</p></entry>
+<entry><p>Application specific</p></entry>
+<entry><p>Tactile: In case of activity, basic button effect and audio feedback
+is provided.</p></entry>
+</row>
+<row>
+<entry><p>Touch down and hold on navigation text</p></entry>
+<entry><p>Inactive</p></entry>
+<entry><p>Tactile: No effect</p></entry>
+</row>
+<row>
+<entry><p>Touch down and hold on arrows</p></entry>
+<entry><p>This action performs a “key repeat”, similar to many touch downs
+and releases on arrow</p></entry>
+<entry><p>Tactile: Sensitive button effect and audio feedback is provided
+with key repeat action.</p></entry>
+</row>
+<row>
+<entry><p>Touch release</p></entry>
+<entry><p>No effect</p></entry>
+<entry><p>Tactile: No effect</p></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<section id="GUID-3E478FC5-080A-4EAF-98F4-B0C0F1C8E19D"><title>Using
+the navi pane in C++ applications</title><p>The API to use for the Navi pane
+is the <xref format="html" href="specs/guides/Navigation_Pane_API_Specification/Navigation_Pane_API_Specification.html" scope="peer">Navigation pane API</xref>. If you use tabs in the Navi pane,
+the API for controlling the tabs is the <xref format="html" href="specs/guides/Tabs_API_Specification/Tabs_API_Specification.html" scope="peer">Tabs API</xref>.</p><p>For the indicators in the Navi pane, use
+the Indicators API.</p><p>For implementation information on the Navi pane,
+see <xref format="html" href="specs/guides/Navigation_Pane_API_Specification/Navigation_Pane_API_Specification.html#Navigation_Pane_API_Specification.topic3" scope="peer">Using the Navigation pane API</xref>. For implementation information
+on tabs, see <xref format="html" href="specs/guides/Tabs_API_Specification/Tabs_API_Specification.html#Tabs_API_Specification.topic3" scope="peer">Using the Tabs API</xref>.</p><p>The class <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classMAknNaviDecoratorObserver.html" format="application/java-archive"><codeph>MAknNaviDecoratorObserver</codeph></xref> provides touch support
+for the tab arrows in the Navi pane. To set the observer, use the method <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknNavigationDecorator.html#660e9ba08945b213aba477b7863873cc" format="application/java-archive"><codeph>CAknNavigationDecorator::SetNaviDecoratorObserver()</codeph></xref>.</p><p>To create a tab group in the Navi pane, use the
+method <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknNavigationControlContainer.html#93d16329080f21bcd8428db61f177abc" format="application/java-archive"><codeph>CreateTabGroupL()</codeph></xref> in the class <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknNavigationControlContainer.html" format="application/java-archive"><codeph>CAknNavigationControlContainer</codeph></xref>. This is a factory
 method for a pre-implemented navigation pane tab group control.</p></section>
 </conbody></concept>
\ No newline at end of file