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-6067DF61-D32F-4029-ADCD-9E69CA564212" xml:lang="en"><title>Key

    13 presses</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>A key press is a press and release of a key (down and up).</p>

    15 <p>Typically, the primary action of the key is performed when the key is pressed

    16 down, already before the key is released (there may be exceptions to this

    17 rule; see <xref href="GUID-26435FE1-D912-4AA2-96EE-82B35DA231E6.dita">Typical functions

    18 of the standard keys</xref> for an example).</p>

    19 <p>Some functions depend on the length of the key press:</p>

    20 <ul>

    21 <li><p>In a short press, the key is held down for less than 0.6 seconds (please

    22 note that this time-out value may depend on the product implementation). If

    23 the key is held down longer, the result is a long key press.</p></li>

    24 <li><p>If the pressed key (in the given context) has functions for both a

    25 short and long press, the short key press action is performed first at the

    26 moment when the key is pressed down. If the key press is long, then the long

    27 key press action is performed. In the case of the Home / Menu key and the

    28 Edit key, the interaction is different, causing the action on the key release

    29 event. </p></li>

    30 <li><p>Certain keys, possibly in certain contexts only, may perform key repeat.

    31 Key repeat starts after the long key press time-out when the key is continuously

    32 being held down, and the associated function is performed according to the

    33 key repeat frequency. For example, in scrolling within lists and text editors,

    34 these frequencies are by default 6 times/second for vertical and 10 times/second

    35 for horizontal scrolling (the repeat frequency may be product or application

    36 specific). </p></li>

    37 <li><p>Long key press actions and key repeat actions are not defined at the

    38 same time; only one can occur in the given context. </p></li>

    39 <li><p>The primary key press action should not be conflicting with the long

    40 key press action or key repeat action.</p></li>

    41 </ul>

    42 <note> With certain input hardware (for example, Roller), long

    43 key presses and key repeat may not be possible. The long key press actions

    44 and key repeat actions should be designed so that this does not cause harm:

    45 the long key press must never be the only way to perform a function</note>

    46 </conbody></concept>