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-32756B46-DAB7-44FA-B710-33EC36E1409F" xml:lang="en"><title>List

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

    14 <p>In a list, browsing is possible in two directions: pressing the Arrow up

    15 key moves the focus one step up (backward), and pressing the Arrow down key

    16 moves the focus one step down (forward).</p>

    17 <p>When browsing, the item in focus must always be visible. The detailed rules

    18 of moving the focus are as follows:</p>

    19 <ul>

    20 <li><p>If the choice item that is becoming focused is already fully visible,

    21 all the items remain in their current positions, and the highlight is moved

    22 from the old item to the new item. </p></li>

    23 <li><p>If the new choice item is not visible, all items are moved in the view

    24 to the appropriate direction so that the new item becomes fully visible. For

    25 example, if the focus is moving down and the new item is currently below the

    26 bottom edge of the view, the items are moved up. </p></li>

    27 <li><p>When moving the choice items in the view, they are only moved the minimum

    28 amount necessary. For example, when moving items up to get the next one under

    29 the bottom edge visible, the item moves to the lowest allowed position in

    30 the view.</p></li>

    31 </ul>

    32 <p>By default, all lists loop. This means that it is possible to browse forward

    33 from the last choice item, which leads to the first item in the list, and

    34 vice versa.</p>

    35 <p>It is possible to specify that a list is a queue. This means that it is

    36 not allowed to browse forward from the last item or browse backward from the

    37 first item. If the user attempts this, the list does not react; there is no

    38 feedback except for the normal keypad tone.</p>

    39 </conbody></concept>