<?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:

Contributors: 

<p>Empty items (that contain no data) can be hidden in a form's View state.

However, this is not a requirement; forms can be designed either way, whichever

is better for the given application.</p>

<p>Unlike ordinary list items, the form items may have different sizes in

the layout but only in the Edit state. A long data field may occupy more than

one line in the Edit state, but in the View state it is truncated to the first

line.</p>

<p>The user may be able to add and remove form items. This is done with commands

in the Options menu.</p>

<p>Form items always have a label. The label has a text part, or a text and

a graphical part; however, all items in one form must have the same column

layout (see <xref href="GUID-CB548959-A1D6-4585-B8E3-B09E37E0CB43.dita">List layouts</xref> for

<p>Any combination of these types is possible within one form.</p>

<p>When a form is in the Edit state, the user can move the focus up and down

like in a list. The highlight in the Edit state is different from the highlight

in the View state, acting as a visual cue. The cursor blinks in the text field

that is in focus. There is no need to save each field separately; the user

can browse and modify the fields in any order and then accept all modifications.

During the browsing of a form in the Edit state, the keypad functions are

as follows:</p>

<table id="GUID-437191CE-D3E0-4CFB-875C-9C308B18F7E9"><title>Default key events

in editing state of a form</title>

<thead>

<row>

<entry>Key</entry>

<entry>Action</entry>

</row>

</thead>

<tbody>

<row>

<entry><p>Arrow up / down</p></entry>

<entry><p>Move the focus between form items (when in a text field, move the

cursor within an item line by line).</p></entry>

</row>

<row>

<entry><p>Arrow left / right</p></entry>

<entry><ul>

<li><p>In a pop-up field: change the value without opening the list. </p></li>

<li><p>In a text field: move the cursor character by character. </p></li>

<li><p>In a slider: adjust the slider value.</p></li>

</ul></entry>

</row>

<row>

<entry><p>Selection key</p></entry>

<entry><ul>

<li><p>In a pop-up field: opens the list. </p></li>

<li><p>In a text field: opens the context sensitive <b>Options</b> menu or

no action.</p></li>

</ul></entry>

</row>

<row>

<entry><p>Left softkey (Options)</p></entry>

<entry><p>Opens the <b>Options</b> menu (in a form without the <b>Options</b> menu,

the left softkey is <b>Done</b>).</p></entry>

</row>

<row>

<entry><p>Right softkey (Done)</p></entry>

<entry><p>Accepts the contents and returns to the previous state (in a form

without the Options menu, the right softkey is Cancel.)</p></entry>

</row>

<row>

<entry><p>Clear</p></entry>

<entry><ul>

<li><p>Pop-up: ignored. </p></li>

<li><p>Text: deletes characters. </p></li>

<li><p>Slider: ignored.</p></li>

</ul></entry>

</row>

<row>

<entry><p>Edit</p></entry>

<entry><ul>

<li><p>Pop-up: ignored. </p></li>

<li><p>Text: opens the editing menu; selects text. </p></li>

<li><p>Slider: ignored.</p></li>

</ul></entry>

</row>

<row>

<entry><p>Numeric keypad</p></entry>

<entry><ul>

<li><p>Pop-up: ignored. </p></li>

<li><p>Text: input. </p></li>

<li><p>Slider: ignored.</p></li>

</ul></entry>

</row>

<row>

<entry><p>Other keys</p></entry>

<entry><p>The default action of the key.</p></entry>

</row>

</tbody>

</tgroup>

</table>

</conbody></concept>