<?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-462239D1-4B40-4342-92DA-32AB0AF0D2F2" xml:lang="en"><title>Creating

the choice list</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>To use a choice list in your application, create an instance of the class <codeph>CAknChoiceList</codeph>. </p>

<p>Use the <codeph>CAknChoiceList::NewL</codeph> parameters to set the style

of the choice list.</p>

<p>If you give no parameters, the defaults will be used. With the default

parameters, a choice list with current selection is constructed.</p>

<p>To construct a choice list without a current selection, use the flag <codeph>CAknChoiceList::EaknChoiceListWithoutCurrentSelection</codeph> and

an instance of <codeph>CaknButton</codeph> in the constructor. This button

will be then used to open the choice list. The ownership of the button is

transferred to the choice list.</p>

<p>The following sample code illustrates creating a default choice list.</p>

<codeblock xml:space="preserve">const TInt KArrayGranularity ( 1 );

   // Create array of choice list items        

    CDesCArrayFlat* array = new ( ELeave ) CDesCArrayFlat ( KArrayGranularity );

    CleanupStack::PushL( array );

    _LIT( KListItem, "Item %d" );

    for ( TInt k = 0; k < 5; k++ )

        {

        TBuf<32> buf;

        buf.Format( KListItem, k );

        array->AppendL( buf );

        }

    // Create choice list with array

    iChoiceList = CAknChoiceList::NewL( this, array );

    CleanupStack::Pop( array );

    iChoiceList->SetObserver( this );

</codeblock>

<p>The following sample code illustrates creating a button choice list with

items from resources:</p>

<codeblock xml:space="preserve"> _LIT( KButtonTxt, "Choice list" );

    _LIT( KButtonHelpTxt, "Button help text" );

    // Create a button for the choice list

    CAknButton* button = CAknButton::NewLC( NULL,

                                            NULL,

                                            NULL,

                                            NULL,

                                            KButtonTxt,

                                            KButtonHelpTxt,

                                            KAknButtonSizeFitText,

                                            0 );

    // Create empty Choice list

    iChoiceList = CAknChoiceList::NewL( this, NULL, 

        CAknChoiceList::EAknChoiceListWithoutCurrentSelection, button );

    CleanupStack::Pop( button );

    // Add items from resource

    iChoiceList->SetItemsL( R_CHOICELISTEX_ITEM_ARRAY );

    iArraySize = ArraySizeL( R_CHOICELISTEX_ITEM_ARRAY );

    iSelection = 0;

    iChoiceList->SetObserver( this );

</codeblock>