Symbian3/SDK/Source/GUID-F1CC06C0-0D3A-4BBC-97E1-E52D2856D7A7.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Tue, 20 Jul 2010 12:00:49 +0100
changeset 13 48780e181b38
parent 8 ae94777fff8f
permissions -rw-r--r--
Week 28 contribution of SDK documentation content. See release notes for details. Fixes bugs Bug 1897 and Bug 1522.

<?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:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-F1CC06C0-0D3A-4BBC-97E1-E52D2856D7A7" xml:lang="en"><title>Find
pane</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>The Find pane is a component intended to help find items in a list. The
Find pane is situated in the bottom part of the main pane.</p>
<fig id="GUID-08B6ECBF-B245-4476-BF17-29894CEBFE21">
<title>Find pane within a selection list of names in Phonebook</title>
<image href="GUID-0EBE8B44-1F42-4654-AC4D-A5F242FA49EB_d0e52257_href.png" placement="inline"/>
</fig>
<p>The standard functionality of the Find pane is as follows:</p>
<ul>
<li><p>Characters typed from the numeric keypad appear at the end of the string
in the Find pane. </p></li>
<li><p>The user can only add and remove characters at the end.</p></li>
<li><p>The Find pane may be hidden until the user types in a character. </p></li>
<li><p>Whenever the find string changes, the list in the main pane is filtered,
and only the items matching the string are displayed. The user can browse
the list normally using the Arrow up and Arrow down keys.</p></li>
</ul>
<p>The Find pane can also be a pop-up window. In this case, it is only displayed
when it is specifically activated.</p>
<section id="GUID-A625A3A9-3D7F-42C0-9FA2-251616E40138"><title>Using
the Find pane in applications</title><p>The APIs to use for the Find pane
are the Searchfield API and the <xref format="html" href="specs/guides/Popups_API_Specification/Popups_API_Specification.html" scope="peer">Popups API</xref>.</p></section>
</conbody></concept>