Nokia Corporation - initial contribution.

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-1AA32C40-CDE0-4627-A634-7C07BB1ED67B" xml:lang="en"><title>Forms</title><prolog><metadata><keywords/></metadata></prolog><conbody>

some editable content. </p>

text fields (alphanumeric or numeric content), pop-up fields and sliders.</p></li>

<p>Forms work with single click. The view state of the form follows list behavior.

Edit state works with single click but it has the highlight always visible

to indicate the active form item. Note that the entire form component item

should be touch sensitive in normal state. This means that even if the user

does not touch the edit field but instead the field header, the item is still

activated.</p>

command in the Options menu. In the Edit state, the contents of the form can

<fig id="GUID-A2BD480A-8FF8-46D2-8C2D-1C300761BBEF">

<title>An example form</title>

<image href="GUID-783161AE-708E-4FB4-8219-EEC0F9939E9B_d0e91346_href.png" placement="inline"/>

</fig>

<p>The following table lists the default touch events for forms:</p>

<table id="GUID-9342F902-5F33-4A51-BCCB-258C4AADAC8C"><title>Default touch

events for forms</title>

<tgroup cols="3">

<colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.03*"/>

<colspec colname="col3" colwidth="1.17*"/>

<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 nameend="col3" namest="col1"><p><b>In Edit State</b></p></entry>

</row>

<row>

<entry><p>Touch down on item</p></entry>

<entry><p>No change</p></entry>

<entry><p>Highlight is shown on the item and focus shifts to the item.</p><p>Tactile:

Basic list effect and audio feedback is provided with touch down event.</p><note> Only

form-specific feedback is provided. No sensitive edit feedback provided on

editor item in the form.</note></entry>

</row>

<row>

<entry><p>Touch release on item</p></entry>

<entry><p>Item is activated.</p><p>When the user moves a cursor to a text

field, the cursor is placed at the end of the text in the field. If the field

is empty, the cursor is placed at the beginning of the field.</p><p>Touch

release on a radio button list item selects the item and closes the pop-up.</p></entry>

<entry><p>Highlight remains on the item.</p><p>In case of a radio button list,

highlight stays on the full list, and not on any single selection item.</p><p>Tactile:

Basic list effect provided with release event.</p></entry>

</row>

<row>

<entry><p>Touch down and hold on item</p></entry>

<entry><p>Inactive</p></entry>

<entry><p>Tactile: No effect</p></entry>

</row>

<row>

<entry><p>Touch down and move inside form</p></entry>

<entry><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging

and flicking</xref> events</p></entry>

<entry><p>Highlight remains on the item that is currently active, when the

user starts to move.</p><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 and move outside the form without releasing touch.</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>

<row>

<entry><p>Touch down and release outside the radio button list</p></entry>

<entry><p>Radio button list is closed.</p></entry>

<entry><p>Tactile: Pop-up effect is provided with touch down event.</p></entry>

</row>

<row>

<entry nameend="col3" namest="col1"/>

</row>

<row>

<entry nameend="col3" namest="col1"><p><b>In View State</b></p></entry>

</row>

<row>

<entry><p>Touch down on item</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 the touch down event.</p></entry>

</row>

<row>

<entry><p>Touch release</p></entry>

<entry><p>One of the following occurs:<ul>

<li><p>Item is activated.</p></li>

<li><p>Item get editable.</p></li>

<li><p>Item opens context specific <b>Options</b> menu.</p></li>

</ul></p></entry>

<entry><p>Highlight disappears.</p><p>Tactile: Basic list effect is provided

with touch release event.</p><p>If the touch release opens a pop-up, the pop-up

open effect is provided with the touch release. If theme effects are ON, then

increasing long touch effect with touch release is provided.</p></entry>

</row>

<row>

<entry><p>Touch down and hold</p></entry>

<entry><p>Inactive</p></entry>

<entry><p>Tactile: No effect</p></entry>

</row>

<row>

<entry><p>Touch down and move inside form</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>

<row>

<entry><p>Touch down and move outside the form without releasing touch.</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>

<section id="GUID-CB9AC4F2-4C2B-49AA-9FCE-E9EA7209CC50"><title>Using

forms in C++ applications</title><p>The API to use for creating forms is the <xref format="html" href="specs/guides/Form_API_Specification/Form_API_Specification.html" scope="peer">Form API</xref>. For implementation information, see <xref format="html" href="specs/guides/Form_API_Specification/Form_API_Specification.html#Form_API_Specification.topic3" scope="peer">Using the Form API</xref>.</p><p>Typically, a form will be derived

from the class <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknForm.html" format="application/java-archive"><codeph>CAknForm</codeph></xref> and

</conbody><related-links>

<linklist><title>Related APIs</title>

<link format="html" href="specs/guides/Dialogs_API_Specification/Dialogs_API_Specification.html" scope="peer"><linktext>Dialogs API</linktext></link>

</linklist>

</related-links></concept>