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-1E446762-AFE2-4198-8CD7-8C4466392543" xml:lang="en"><title>Choice

    13 list API class structure</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>The class structure for the Choice list API consists of the class <codeph>CAknChoiceList</codeph> and

    15 observer interface <codeph>McoeControlObserver</codeph>. The class structure

    16 is depicted in the figure below.</p>

    17 <fig id="GUID-F3AE7068-6277-4A02-B057-8324487F5D2F">

    18 <title>Choice list API classes</title>

    19 <image href="GUID-0991E536-97B2-4EAA-9448-A090BD073140_d0e75219_href.png" scale="50" placement="inline"/>

    20 </fig>

    21 <p>The <codeph>CAknChoiceList</codeph> class provides an interface for controlling

    22 the choice list. You need to create separate instances of this class for each

    23 choice list. </p>

    24 <p>When you use the choice list component in your application, you must implement

    25 the <codeph>McoeControlObserver</codeph> interface. This interface is used

    26 as a callback hook between the client application and the actual choice list.

    27 The client application receives a notification through this interface when

    28 the choice list is closed. This enables you to determine what to do with the

    29 changed selection from the choice list in your client application.</p>

    30 </conbody></concept>