classicui_pub/lists_api/inc/aknlists.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Wed, 31 Mar 2010 21:59:52 +0300
branchRCL_3
changeset 15 08e69e956a8c
parent 0 2f259fa3e83a
permissions -rw-r--r--
Revision: 201011 Kit: 201013

/*
* Copyright (c) 2002-2010 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "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:
*
* Description: 
*
*/

#ifndef __AKNLISTS_H__
#define __AKNLISTS_H__

#include <eikclb.h>
#include <eikfrlb.h>
#include <eikslb.h>
#include <AknGrid.h>
#include <AknUtils.h>

#include <AknPanic.h>


class TAknTextLineLayout;
class MAknsSkinInstance;
class MAknsControlContext;

/** THIS FILE INCLUDES:
 *  1) All listbox layouts specified in Avkon LAF specification
 *      a) General list pane descendants
 *      b) Pop up window list pane descendants
 *      c) Grid panes
 *  2) Utilities that help building listbox layouts based on LAF specification
 *  3) Other helper classes that handle listbox behavior
 */


//
//
// Helper template definitions.
// (these are before concrete listbox classes because they're needed for inheritance)
//


/**
 * This adds correct horizontal and vertival lines to the listbox and handles empty listbox!
 *
 * This class is only useful if you're writing your own list layout. 
 * Please use the predefined layouts instead, for example CAknSingleStyleListBox.
 */
template<class T>
class AknListBoxLinesTemplate : public T
    {
public:
    /** AknListBoxLinesTemplate
     *
     * Read AVKON_LISTBOX_LINES resources. 
     *
     * The following predefined lines are available:
     * R_LIST_PANE_LINES_A_COLUMN
     * R_LIST_PANE_LINES_AB_COLUMN
     * R_LIST_PANE_LINES_AB_COLUMN_X
     * R_LIST_PANE_LINES_AB_COLUMN_XX
     * R_LIST_PANE_LINES_BC_COLUMN
     * R_LIST_PANE_LINES_BC_COLUMN_X
     * R_LIST_PANE_LINES_BC_COLUMN_XX
     * 
     */
    IMPORT_C AknListBoxLinesTemplate(TInt aResourceId);
    /** SizeChanged()
     * 
     * Determines position of the lines
     */
    IMPORT_C void SizeChanged();
    /** Draw()
     * 
     * Draws the lines
     */
    IMPORT_C void Draw(const TRect& aRect) const;
    /** CountComponentControls()
     * 
     * Choose controls to use as child controls
     */
    IMPORT_C TInt CountComponentControls() const;
    /** CountComponentControls()
     * 
     * Choose controls to use as child controls
     */
    IMPORT_C CCoeControl* ComponentControl(TInt aIndex) const;

private:
    TInt iSpare0;                           // was iResourceId;
    TAknLayoutRect iVertLine1, iVertLine2;  // not used
    TAknLayoutRect iHoriLine;               // not used
    TBool iResized;
    TInt iSpare[2];
    };

/**
 * Empty layout for popup lists
 */

template<class T>
class AknPopupListEmpty : public T
    {
   /**
    * Draws empty list when needed. See AknDraw::DrawEmptyList().
    */
    IMPORT_C virtual void Draw(const TRect &aRect) const;
    };


	/** 
	* Avkon version of eikon's column listbox.
	* Content for list items are tab-separated strings.
	*
	* See methods 
	*   CEikListBox::ConstructFromResourceL()
	*   CEikListBox::ConstructL()
	*   CEikTextListBox::SetItemArray()
	*   CEikColumnListBoxData::SetIconArray()
	* 
	* Related flags for ConstructL() (avkon.hrh)
	*   EAknListBoxSelectionList
	*   EAknListBoxMenuList
	*   EAknListBoxMarkableList
	*   EAknListBoxMultiselectionList
	*   EAknListBoxViewerFlags
	*
	* Related flags for dialogs (avkon.hrh)
	*   EAknDialogSelectionList
	*   EAknDialogMenuList
	*   EAknDialogMultiselectionList
	*
	* @since Series 60 0.9
	*
	*/
class CAknColumnListBox : public CEikColumnListBox
    {
public:
    /** 
	* Creates new @c CAknColumnListBoxView object and returns pointer to it.
	* @return Pointer to the list box view which displays the list items which
	* are currently visible in a list box.
    */
    IMPORT_C virtual CListBoxView* MakeViewClassInstanceL();
    
    /** 
    * Creates @c CAknFilteredTextListBoxModel object.
    */
    IMPORT_C virtual void CreateModelL();

    /** 
    * Listbox rectangle calculation. Rounds down the height of the rectangle
    * (if necessary) so that only a whole number of items can be displayed
    * inside the list box.
    * @param aRect The size of the listbox.
    * @return The number of pixels reduced.
    */
    IMPORT_C virtual TInt AdjustRectHeightToWholeNumberOfItems(TRect& aRect) const;
    
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);
private:
    /**
    * From CAknControl
    */
    IMPORT_C void* ExtensionInterface( TUid aInterface );
private: // listbox use only
	IMPORT_C virtual void CEikListBox_Reserved(); 
    };


//
// These define what features are needed --> you can remove shortcuts from ALL lists by changing these..
// Templates available: AknListBoxLinesTemplate<> AknListBoxShortCutTemplate<>
typedef AknListBoxLinesTemplate<CAknColumnListBox > CEikColumnListBoxTypedef;
typedef AknListBoxLinesTemplate<CEikFormattedCellListBox > CEikFormattedCellListBoxTypedef;
typedef AknListBoxLinesTemplate<CEikSettingsListBox > CEikSettingsListBoxTypedef;
typedef CAknGrid CAknSelectionGridTypedef;

// Templates available: AknListBoxShortCutTemplate<> AknListBoxLinesTemplate<>
#define AKNCOLUMNLISTBOXNAME(x) AknListBoxLinesTemplate<CAknColumnListBox >(x)
#define AKNDOUBLELISTBOXNAME(x) AknListBoxLinesTemplate<CEikFormattedCellListBox >(x)
#define AKNSETTINGLISTBOXNAME(x) AknListBoxLinesTemplate<CEikSettingsListBox >(x)

// Templates available: AknListBoxLinesTemplate<>, AknListBoxShortCutTemplate<>
#define AKNCOLUMNLISTBOX AknListBoxLinesTemplate<CAknColumnListBox >
#define AKNFORMATTEDLISTBOX AknListBoxLinesTemplate<CEikFormattedCellListBox >
#define AKNSETTINGSLISTBOX AknListBoxLinesTemplate<CEikSettingsListBox >
#define AKNGRID CAknGrid







//
//
// Derived listboxes (Use these in applications!)
// These are only for full screen lists -- the Rect() of the list must be ClientRect()
//
//


/**
 * list_single_pane
 *
 * list item string format: "\tTextLabel\t0\t1"
 * where 0 and 1 are indexes to icon array
 */

class CAknSingleStyleListBox : public CEikColumnListBoxTypedef
    {
public:
    IMPORT_C CAknSingleStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);  
private:
    void SizeChangedL();
    };

/**
 * list_single_number_pane
 *
 * list item string format: "2\tTextLabel\t0\t1"
 * where 0 and 1 are indexes to icon array
 */

class CAknSingleNumberStyleListBox : public CEikColumnListBoxTypedef
    {
public:
    IMPORT_C CAknSingleNumberStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);   
private:
    void SizeChangedL();
    };

/**
 * list_single_heading_pane
 *
 * list item string format: "Heading\tTextLabel\t0\t1"
 * where 0 and 1 are indexes to icon array
 *
 */

class CAknSingleHeadingStyleListBox : public CEikColumnListBoxTypedef
    {
public:
    IMPORT_C CAknSingleHeadingStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 

protected:
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
    
   /** MakeViewClassInstanceL()
    *
    * Chooses which listbox view class to use
    */
    IMPORT_C virtual CListBoxView* MakeViewClassInstanceL();
private:
    void SizeChangedL();
    };


/**
 * list_single_graphic_pane
 *
 * list item string format: "0\tTextLabel\t1\t2"
 * where 0,1,2 are index to the icon array 
 */

class CAknSingleGraphicStyleListBox : public CEikColumnListBoxTypedef
    {
public: 
    IMPORT_C CAknSingleGraphicStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
private:
    void SizeChangedL();
    };

/**
 * list_single_Graphic_heading_pane
 *
 * list item string format: "0\tHeading\tTextLabel\t1\t2"
 * where 0,1,2 are index to the icon array 
 */

class CAknSingleGraphicHeadingStyleListBox : public CEikColumnListBoxTypedef
    {
public:
    IMPORT_C CAknSingleGraphicHeadingStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);    
protected:
    IMPORT_C virtual void CreateItemDrawerL();
   /** MakeViewClassInstanceL()
    *
    * Chooses which listbox view class to use
    */
    IMPORT_C virtual CListBoxView* MakeViewClassInstanceL();
private:
    void SizeChangedL();
    };

/**
 * list_single_number_heading_pane
 *
 * list item string format: "1\tHeading\tTextLabel\t2\t3"
 * where 2 and 3 are indexes to icon array
 */

class CAknSingleNumberHeadingStyleListBox : public CEikColumnListBoxTypedef
    {
public:
    IMPORT_C CAknSingleNumberHeadingStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
protected:
    IMPORT_C virtual void CreateItemDrawerL();
   /** MakeViewClassInstanceL()
    *
    * Chooses which listbox view class to use
    */
    IMPORT_C virtual CListBoxView* MakeViewClassInstanceL();
private:
    void SizeChangedL();
    };

/**
 * list_single_large_pane
 *
 * list item string format: "1\tTextLabel\t0\t0"
 * where 0 is an index to icon array
 */

class CAknSingleLargeStyleListBox : public CEikColumnListBoxTypedef
    {
public:
    IMPORT_C CAknSingleLargeStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);   
private:
    void SizeChangedL();
    };

/**
 * list_double_pane and list_big_single_pane
 *
 * list item string format: " \tFirstLabel\tSecondLabel\t0\t0"
 * where 0 is an index to icon array
 */

class CAknDoubleStyleListBox : public CEikFormattedCellListBoxTypedef
    {
public:
    IMPORT_C CAknDoubleStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
private:
    void SizeChangedL();
    };

/**
 * list_twoline_pane
 *
 * list item string format: " \tFirstLongLabel\t\t0"
 * where 0 is an index to icon array
 */

class CAknDoubleStyle2ListBox : public CAknDoubleStyleListBox
    {
public:
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C void CreateItemDrawerL();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);
private:
    void SizeChangedL();
    };

 /**
 * list_double_number_pane and list_big_single_number_pane
 *
 * list item string format: "1\tFirstLabel\t\t0\t0"
 * list item string format: "1\tFirstLabel\tSecondLabel\t0\t0"
 * where 0 is an index to icon array
 *
 */

class CAknDoubleNumberStyleListBox : public CEikFormattedCellListBoxTypedef
    {
public:
    IMPORT_C CAknDoubleNumberStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
private:
    void SizeChangedL();
    };

/**
 * list_double_time_pane
 */

class CAknDoubleTimeStyleListBox : public CEikFormattedCellListBoxTypedef
    {
public:
    IMPORT_C CAknDoubleTimeStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);
private:
    void SizeChangedL();
    };

/**
 * list_double_large_pane
 *
 * list item string format: "1\tFirstLabel\tSecondLabel\t0\t0"
 *
 * where 0 is an index of small (13x13) icon in icon array
 *   and 1 is an index of a thumbnail image
 *
 * Good thumbnail image sizes for this list are:
 *   30x40, 36x44, 40x30, 40x48, 44x36.
 */

class CAknDoubleLargeStyleListBox : public CEikFormattedCellListBoxTypedef
    {
public:
    IMPORT_C CAknDoubleLargeStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
private:
    void SizeChangedL();
    };


/**
 * list_double_graphic_pane
 *
 * list item string format: "0\tFirstLabel\tSecondLabel\t0"
 * where 0 is index to icon array
 *
 */

class CAknDoubleGraphicStyleListBox : public CEikFormattedCellListBoxTypedef
    {
public:
    IMPORT_C CAknDoubleGraphicStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
private:
    void SizeChangedL();
    };


/** 
 * list_double2_graphic_pane
 *
 * list item string format: "0\tFirstLabel\tSecondLabel\t0"
 * where 0 is index to icon array
 *
 */

class CAknDouble2GraphicStyleListBox : public CEikFormattedCellListBoxTypedef
    {
public:
    IMPORT_C CAknDouble2GraphicStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();

	/** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C void CreateItemDrawerL();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
private:
    void SizeChangedL();
    };


/**
 * list_double2_large_graphic_pane
 *
 * list item string format: "1\tFirstLabel\tSecondLabel\t0"
 *
 * where 0 is an index of small (13x13) icon in icon array
 *   and 1 is an index of a thumbnail image
 *
 */

class CAknDouble2LargeStyleListBox : public CEikFormattedCellListBoxTypedef
    {
public:
    IMPORT_C CAknDouble2LargeStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
private:
    void SizeChangedL();
    };


/**
*  list_double2_graphic_large_graphic_pane
*
*  This is similar but not identical to
*  java list CAknDouble2GraphicLargeStyleListBox
*
*  list item string format: "0\t1\tFirstLabel\tSecondLabel\t2\t3"
*
*  where 0 (mandatory), 2 and 3 (optional) are an index of small icon
*  in icon array and 1 (mandatory) is an index of a thumbnail image
*
*  @lib avkon
*  @since Series 60 2.8
*/

class CAknDouble2GraphicLargeGraphicStyleListBox : public CEikFormattedCellListBoxTypedef
    {
public:
    IMPORT_C CAknDouble2GraphicLargeGraphicStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);   
private:
    void SizeChangedL();
    };


/**
 * list_double2_graphic_pane
 *
 * list item string format: "1\tFirstLabel\tSecondLabel\t0"
 * where 0 is an index to icon array
 *
 */

class CAknFormDoubleGraphicStyleListBox : public CAknDoubleGraphicStyleListBox
    {
public:
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
private:
    void SizeChangedL();
    };
typedef CAknFormDoubleGraphicStyleListBox CAknSingleBigHeadingGraphicListBox;

/**
 * list_double2_pane
 *
 * list item string format: " \tFirstLabel\tSecondLabel\t0"
 * where 0 is an index to icon array
 */

class CAknFormDoubleStyleListBox : public CAknDoubleStyleListBox
    {
public:
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
private:
    void SizeChangedL();
    };
typedef CAknFormDoubleStyleListBox CAknSingleBigHeadingListBox;


/**
 * list_setting_pane and list_big_single_setting_pane
 *
 * list item string format: "\tFirstLabel\t\tValueText"
 * list item string format: "\tFirstLabel\t0\t"
 * list item string format: "\tFirstLabel\t\tValueText\t*"
 * list item string format: "\tFirstLabel\t\t\t\tSecondLabel"
 * where 0 is an index to icon array
 */

class CAknSettingStyleListBox : public CEikSettingsListBoxTypedef
    {
public:
    IMPORT_C CAknSettingStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
private:
    void SizeChangedL();
    };

/**
 * list_setting_number_pane and list_big_single_setting_number_pane
 *
 * list item string format: "1\tFirstLabel\t\tValueText"
 * list item string format: "2\tFirstLabel\t0\t"
 * list item string format: "3\tFirstLabel\t\tValueText\t*"
 * list item string format: "4\tFirstLabel\t\t\t\tSecondLabel"
 * where 0 is an index to icon array
 * and 1..4 is list item number shown on screen
 */
class CAknSettingNumberStyleListBox : public CEikSettingsListBoxTypedef
    {
public:
    IMPORT_C CAknSettingNumberStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
private:
    void SizeChangedL();
    };


//
// Use the popup styles with CAknPopupList and CAknListQueryDialog
//

/**
 * list_single_popup_menu_pane
 *
 * list item string format: "FirstLabel\t0"
 *
 * where 0 is an index to icon array
 */

class CAknSinglePopupMenuStyleListBox : public AknPopupListEmpty<CEikFormattedCellListBox>
    {
public:
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    protected:
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);
private:
    void SizeChangedL();
    };

/**
 * list_single_graphic_popup_menu_pane
 *
 * list item string format: "0\tLabel"
 *
 * where 0 is an index to icon array
 */

class CAknSingleGraphicPopupMenuStyleListBox : public AknPopupListEmpty<CEikFormattedCellListBox>
    {
public:
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    protected:
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);  
private:
    void SizeChangedL();
    };

/**
 * list_single_graphic_bt_popup_menu_pane
 *
 * list item string format: "0\tLabel"
 *
 * where 0 is an index to icon array
 *
 */

class CAknSingleGraphicBtPopupMenuStyleListBox : public CAknSingleGraphicPopupMenuStyleListBox
    {
public:
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C virtual void SizeChanged();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);    
    };

/**
 * list_single_heading_popup_menu_pane
 *
 * list item string format: "Heading\tLabel"
 *
 */

class CAknSingleHeadingPopupMenuStyleListBox : public AknPopupListEmpty<CEikFormattedCellListBox>
    {
public:
    IMPORT_C CAknSingleHeadingPopupMenuStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);    
protected:
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
private:
    void SizeChangedL();
    };


/**
 * list_single_graphic_heading_popup_menu_pane
 *
 * list item string format: "0\tHeading\tLabel"
 *
 * where 0 is an index to icon array
 *
 */

class CAknSingleGraphicHeadingPopupMenuStyleListBox : public AknPopupListEmpty<CEikFormattedCellListBox>

    {
public:
    IMPORT_C CAknSingleGraphicHeadingPopupMenuStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
protected:
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
private:
    void SizeChangedL();
    };

/**
 * list_double_popup_menu_pane
 *
 * list item string format: "FirstLabel\tSecondLabel"
 *
 */

class CAknDoublePopupMenuStyleListBox : public AknPopupListEmpty<CEikFormattedCellListBox>
    {
public:
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
protected:
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
private:
    void SizeChangedL();
    };

/**
 * list_single_popup_submenu_pane
 *
 * DO NOT USE
 *
 */

class CAknSinglePopupSubmenuStyleListBox : public AknPopupListEmpty<CEikFormattedCellListBox>
    {
public:
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
private:
    void SizeChangedL();
    };


/**
 * list_double_large_graphic_popup_menu_pane
 *
 * list item string format: "0\tFirstLabel\tSecondLabel"
 *
 * where 0 is an index to icon array
 *
 */

class CAknDoubleLargeGraphicPopupMenuStyleListBox : public AknPopupListEmpty<CEikFormattedCellListBox>
    {
public:
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);
protected:
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
private:
    void SizeChangedL();
    };


/**
 * list_double2_popup_menu_pane
 *
 * list item string format: "FirstLabel\tSecondLabel"
 *
 */

class CAknDouble2PopupMenuStyleListBox : public AknPopupListEmpty<CEikFormattedCellListBox>
    {
public:
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);  
protected:
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
private:
    void SizeChangedL();
    };
    
    
/**
 * list_single_2graphic_pane_cp2
 *
 * list item string format: "0\t1\tTextLabel\t2\t3"
 *
 * where 0,1,2,3 are index to the icon array 
 */

class CAknSingle2GraphicPopupMenuStyleListBox : public AknPopupListEmpty<CEikFormattedCellListBox>
    {
public:
    IMPORT_C CAknSingle2GraphicPopupMenuStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    protected:
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);
private:
    void SizeChangedL();
    };



/**
 * list_double_graphic_pane
 *
 * list item string format: "0\tFirstLabel\tSecondLabel\t1\t2"
 * where 0 is index to icon array
 *
 */
class CAknDoubleGraphicPopupMenuStyleListBox : public AknPopupListEmpty<CEikFormattedCellListBox>
    {
public:
    IMPORT_C CAknDoubleGraphicPopupMenuStyleListBox();
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    protected:
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);
private:
    void SizeChangedL();
    };
    
// --- end of popup styles



/** list_set_pane
 * Setting Page component uses this
 *
 * list item string format: "1\tShortLabel"
 * list item string format: "\t\tLongLabel"
 *
 */
class CAknSetStyleListBox : public AknPopupListEmpty<CEikFormattedCellListBox>
    {
public:
    IMPORT_C void ConstructWithWindowL(const CCoeControl *aParent, TInt aFlags);
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the listbox for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    IMPORT_C void Draw(const TRect& aRect) const;
    IMPORT_C TTypeUid::Ptr MopSupplyObject(TTypeUid aId);

    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 

protected:
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
   /** MakeViewClassInstanceL()
    *
    * Chooses which listbox view class to use
    */
    IMPORT_C CListBoxView *MakeViewClassInstanceL();
private:
    void SizeChangedL();
    };

/** list_form_graphic_pane
 * Form popup field should use this
 *
 * list item string format: "1\tShortLabel"
 * list item string format: "\t\tLongLabel"
 *
 */
class CAknFormGraphicStyleListBox : public AknPopupListEmpty<CEikFormattedCellListBox>
    {
public:
    IMPORT_C void ConstructWithWindowL(const CCoeControl *aParent, TInt aFlags);
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the grid for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /** CreateItemDrawerL()
     *
     * Chooses which itemdrawer to use.
     */
    IMPORT_C virtual void CreateItemDrawerL();
    /** Listbox rectangle calculation.
     */
    IMPORT_C virtual TInt AdjustRectHeightToWholeNumberOfItems(TRect &aRect) const;
     /**
     * From CCoeControl
     * Handles pointerevents of popupfield's list
     * @param aPointerEvent pointerevent to be handled
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 
private:
    void SizeChangedL();
	};

class CAknFormGraphicWideStyleListBox : public CAknFormGraphicStyleListBox
    {
public:
    IMPORT_C void SizeChanged();
    IMPORT_C TSize MinimumSize();
    // From CCoeControl
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);  
private:
    void SizeChangedL();
    };


/** grid_app_pane
 * Application Shell uses this (note that part of layout needs to be done
 * inside application -- the listbox will not be in correct position on the
 * screen by just using this -- see listapp)
 *
 * list item string format: "1\tLabel"
 * list item string format: "1\tLabel\t1"
 */

/**
 * grid_pinb_pane
 *
 * list item string format: "1"
 * list item string format: "1\t1"
 * list item string format: "1\t1\t1"
 * list item string format: "1\t\t1"
 */

class CAknPinbStyleGrid : public CAknSelectionGridTypedef
    {
public:
    /** SizeChanged()
     * 
     * Determines layout of the grid
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the grid for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();

    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 

private:    
    void SizeChangedL();
    };


/**
 * grid_qdial_pane
 */

class CAknQdialStyleGrid : public CAknSelectionGridTypedef
    {
public:
    /** SizeChanged()
     * 
     * Determines layout of the grid
     */
    IMPORT_C virtual void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the grid for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();

    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent); 

private:
    void SizeChangedL();
    };

/**
 * grid_cale_month_pane
 */

class CAknCaleMonthStyleGrid : public CAknSelectionGridTypedef
    {
public:
    /** SizeChanged()
     * 
     * Determines layout of the listbox
     */
    IMPORT_C void SizeChanged();
    /** MinimumSize()
     * 
     * Determines size of the grid for use in dialogs.
     */
    IMPORT_C TSize MinimumSize();
    /**
     * From CCoeControl.     
     * Handles pointer events
     */
    IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);  

private:
    void SizeChangedL();
    };



//
//
// Here we have itemdrawer/view modifications needed by the lists
//
//

// This class is to keep drawing routines that depend on avkon and which we cannot place to
// eikstd or uikon because of that.

	/**
 	* A view that provides empty lists for use with find pane
 	* @since Series 60 0.9
 	*/
class CAknColumnListBoxView : public CColumnListBoxView
    {
public:

	/**
	* Enables find in empty list. Basically same as @c SetFindEmptyListState()
	* when it is set @c ETrue.
	*/
    IMPORT_C void EnableFindEmptyList();
    
    /**
    * Sets find in empty list visible or hides it.
    * @param aUsedWithFind Setter to set find visible or to hide it.
    */
    IMPORT_C void SetFindEmptyListState(TBool aUsedWithFind);
    
    /**
    * Draws empty list with or without find depending if it has been enabled.
    * @param aClientRect The client rectangle.
    */
    IMPORT_C void DrawEmptyList(const TRect &aClientRect) const;
    
    /**
    * Calls @c CColumnListBoxView::CalcBottomItemIndex() and removes filtering
    * from find box if new list items are added. Called by listbox control when
    * either the size of the listbox or the number of items in its model has
    * changed.
    */
    IMPORT_C virtual void CalcBottomItemIndex();
    TBool GetFindEmptyListState();    
private: // overridden from CListBoxView
	IMPORT_C virtual TAny* Reserved_1();
private:
    TBool iEmptyListWithFind;
    };

/**
 * empty list for settings item editing
 */

class CAknSetStyleListBoxView : public CFormattedCellListBoxView
    {
public:
    IMPORT_C void DrawEmptyList(const TRect &aClientRect) const ;
private: // overridden from CListBoxView
	IMPORT_C virtual TAny* Reserved_1();
    };


/**
 * Horizontal lines and empty list support for views
 */

class CSingleHeadingStyleView : public CAknColumnListBoxView
    {
public:
    IMPORT_C void Draw(const TRect* ) const;
    IMPORT_C void DrawEmptyList(const TRect& aClientRect) const;
private: // overridden from CListBoxView
	IMPORT_C virtual TAny* Reserved_1();
    };

/**
 * Horizontal lines support for item drawer.
 */
class CSingleHeadingStyleItemDrawer : public CColumnListBoxItemDrawer 
    {
public:
    IMPORT_C CSingleHeadingStyleItemDrawer(MTextListBoxModel* aTextListBoxModel, const CFont* aFont, CColumnListBoxData* aColumnData);
    IMPORT_C ~CSingleHeadingStyleItemDrawer();

    IMPORT_C virtual void DrawItem(TInt aItemIndex, TPoint aItemRectPos, TBool aItemIsSelected, TBool aItemIsCurrent, TBool aViewIsEmphasized, TBool aViewIsDimmed) const;

public:
    IMPORT_C void SetTopItemIndex(TInt aTop);

private:
    TInt iTopItemIndex;
	CCoeEnv* iCoeEnv;
    };

/**
 * Thumbnail image positioning for double large styles.
 */
class CDoubleLargeStyleItemDrawer : public CFormattedCellListBoxItemDrawer
    {
public:
    IMPORT_C CDoubleLargeStyleItemDrawer(MTextListBoxModel* aTextListBoxModel, const CFont* aFont, CFormattedCellListBoxData* aFormattedCellData, CEikListBox *aListBox);
    IMPORT_C void DrawItem(TInt aItemIndex, TPoint aItemRectPos, TBool aItemIsSelected, TBool aItemIsCurrent, TBool aViewIsEmphasized, TBool aViewIsDimmed) const;
private:
	IMPORT_C void CFormattedCellListBoxItemDrawer_Reserved();
private:
    CEikListBox *iListBox_tmp;
    };


/**
 * Word wrapping for double2 styles
 */
class CWordWrappedFormattedCellItemDrawer : public CFormattedCellListBoxItemDrawer
    {
public:
    IMPORT_C CWordWrappedFormattedCellItemDrawer(MTextListBoxModel* aTextListBoxModel, const CFont* aFont, CFormattedCellListBoxData* aFormattedCellData, CEikListBox *aListBox, TInt aSubCell, TInt aSubCell2);
    IMPORT_C void DrawItem(TInt aItemIndex, TPoint aItemRectPos, TBool aItemIsSelected, TBool aItemIsCurrent, TBool aViewIsEmphasized, TBool aViewIsDimmed) const;
    IMPORT_C void DrawItemText(TInt aItemIndex,
			       const TRect &aItemTextRect,
			       TBool aItemIsCurrent,
			       TBool,
			       TBool aItemIsSelected) const;
private:
	IMPORT_C void CFormattedCellListBoxItemDrawer_Reserved();
private:
    TInt iSubCell, iSubCell2;
    };

//
//
//  here starts section for building new listboxes.
//

//
// This is helper class that makes the conversion between European LAF and
// different listbox itemdrawer implementations.
//
// Notice, this CEikListBox is a good friend with this class.
//
// 

/** AknListBoxLayouts
 * Building listbox layouts from European Avkon LAF.
 *
 * The LAF specification has 3 kinds of tables:
 *   Graphics tables
 *   Text tables
 *   Pane coordinates
 * The graphics tables map to SetupColumnGfxCell() and SetupFormGfxCell()
 * The text tables map to SetupColumnTextCell() and SetupFormGfxCell()
 * The pane coordinates map to SetupListboxPos().
 *
 * This class is mostly useless if you don't have LAF specification available!
 *
 * You probably want to use predefined layouts; See CAknSingleStyleListBox.
 *
 * NOTE: This class is old design. You should consider looking at aknutils.h: AknLayoutUtils
 *       whenever you want to build things from the LAF specification. 
 */

class AknListBoxLayouts
    {
public:
    /**
     * Setup borders etc.
     */
    IMPORT_C static void SetupStandardListBox(CEikListBox& aListBox);
     /**
     * Setup grid position
     * since 2.0
     */
    static void SetupGridPos(CAknGrid& aGrid,
                     const TAknWindowLineLayout &aLayout);
   /**
     * Setup grid position
     */
    IMPORT_C static void SetupGridPos(CAknGrid& aGrid,
    			     TInt l, 
    			     TInt t, 
    			     TInt /*r*/, 
    			     TInt /*b*/, 
    			     TInt W, 
    			     TInt H);
    /**
     * Setup list position
     */
    IMPORT_C static void SetupListboxPos(CEikListBox& aListBox,
				TInt startx, 
    				TInt starty, 
    				TInt,
    				TInt, 
    				TInt /*width*/, 
    				TInt height);

    /*
    * non-exported new internal version
    */
    static void SetupListboxPosL( CEikListBox& aListBox,
                                  const TAknWindowLineLayout& aLayout ); // layout of first item
        
    /**
     * Setup text foreground and background colors to default
     */
    IMPORT_C static void SetupStandardColumnListbox(CColumnListBoxItemDrawer* aItemDrawer);	
    /**
     * Setup text foreground and background colors to default
     */
    IMPORT_C static void SetupStandardFormListbox(CFormattedCellListBoxItemDrawer* aItemDrawer);
    /**
     * Setup text foreground and background colors to default
     */
    IMPORT_C static void SetupStandardGrid(CAknGrid& aGrid);
    
    /**
     * Setup a single graphics cell of list item
     */
    IMPORT_C static void SetupColumnGfxCell(CEikListBox& aListBox, 
				   CColumnListBoxItemDrawer* aItemDrawer, 
				   TInt index,
				   TInt l, 
				   TInt t, 
				   TInt r, 
				   TInt b, 
				   TInt W, 
				   TInt H, 
				   TInt startx, 
				   TInt endx);
    
    /**
     * Setup a single text cell of list item
     */
    IMPORT_C static void SetupColumnTextCell(CEikListBox& aListBox, 
				    CColumnListBoxItemDrawer* aItemDrawer, 
				    TInt index,
				    const CFont *font, 
				    TInt /*C*/, 
				    TInt lm, 
				    TInt rm, 
				    TInt B, 
				    TInt /*W*/, 
				    CGraphicsContext::TTextAlign aAlign, 
				    TInt startx, 
				    TInt endx);
    /**
     * Setup a single text cell of list item
     */
    IMPORT_C static void SetupColumnTextCell(CEikListBox& aListBox, 
				    CColumnListBoxItemDrawer* aItemDrawer, 
				    TInt index,
				    const TAknTextLineLayout &aLayout,
				    TInt startx, 
				    TInt endx); // use with aknlayoutcompiler

    /**
     * Setup a single graphics cell of list item
     */
    IMPORT_C static void SetupFormGfxCell(CEikListBox& aListBox, 
				 CFormattedCellListBoxItemDrawer* aItemDrawer, 
				 TInt index,
				 TInt l, 
				 TInt t, 
				 TInt /*r*/, 
				 TInt /*b*/, 
				 TInt W, 
				 TInt H, 
				 TPoint p1, 
				 TPoint p2);


    /**
     * Setup a single graphics cell of list item
     *
     * This version is needed for grid cells. (the FormGfxCell works in
     * most cases, but this is needed if you want exact positioning of
     * the erased area..)
     */
    IMPORT_C static void SetupGridFormGfxCell(CAknGrid& aListBox, 
				 CFormattedCellListBoxItemDrawer* aItemDrawer, 
				 TInt index,
				 TInt l, 
				 TInt t, 
				 TInt /*r*/, 
				 TInt /*b*/, 
				 TInt W, 
				 TInt H, 
				 TPoint aP1, 
				 TPoint aP2);
    /**
     * Setup a single graphics cell of list item
     *
     * This version is needed for grid cells. (the FormGfxCell works in
     * most cases, but this is needed if you want exact positioning of
     * the erased area..)
     * since 2.6
     */

    IMPORT_C static void SetupGridFormGfxCell(CAknGrid& aGrid,
                 CFormattedCellListBoxItemDrawer* aItemDrawer, 
                 TInt aIndex,
                 const TAknWindowLineLayout& aLine,
                 TPoint& aP1, 
                 TPoint& aP2);         

    /**
     * Setup a single text cell of list item
     */    
    IMPORT_C static void SetupFormTextCell(CEikListBox& aListBox, 
				  CFormattedCellListBoxItemDrawer* aItemDrawer, 
				  TInt index,
				  const CFont *font, 
				  TInt /*C*/, 
				  TInt lm,
				  TInt /*rm*/, 
				  TInt B, 
				  TInt W, 
				  CGraphicsContext::TTextAlign aAlign, 
				  TPoint p1, 
				  TPoint p2);
    /**
     * Setup a single text cell of list item
     *
     * This is for removing flicker for settings
     *
     */
    IMPORT_C static void SetupFormAntiFlickerTextCell(CEikListBox& aListBox, 
				  CFormattedCellListBoxItemDrawer* aItemDrawer, 
				  TInt index,
				  const CFont *font, 
				  TInt /*C*/, 
				  TInt lm,
				  TInt /*rm*/, 
				  TInt B, 
				  TInt W, 
				  CGraphicsContext::TTextAlign aAlign, 
				  TPoint p1, 
				  TPoint p2);

    /**
     * Setup a single text cell of list item
     */
    IMPORT_C static void SetupFormTextCell(CEikListBox& aListBox, 
				  CFormattedCellListBoxItemDrawer* aItemDrawer, 
				  TInt index,
				  const TAknTextLineLayout &aLayout,
				  const TPoint &p1, 
				  const TPoint &p2); // use with layout compiler
    /**
     * Setup a single text cell of list item
     *
     * This is for removing flicker for settings
     */
    IMPORT_C static void SetupFormAntiFlickerTextCell(CEikListBox& aListBox, 
				  CFormattedCellListBoxItemDrawer* aItemDrawer, 
				  TInt index,
				  const TAknTextLineLayout &aLayout,
				  const TPoint &p1, 
				  const TPoint &p2); // use with layout compiler

    /**
     * Setup a graphic element for a column listbox using aknlayout.dll
     */
    IMPORT_C static void SetupColumnGfxCell(CEikListBox& aListBox, 
				   CColumnListBoxItemDrawer* aItemDrawer, 
				   TInt aIndex,
				   const TAknWindowLineLayout &aLayout,
				   TInt startx, 
				   TInt endx);

    /**
     * Setup a single graphics cell of list item using aknlayout.dll
     */
    IMPORT_C static void SetupFormGfxCell(CEikListBox& aListBox, 
				 CFormattedCellListBoxItemDrawer* aItemDrawer, 
				 TInt index,
				 const TAknWindowLineLayout &aLayout,
				 const TPoint &p1, 
				 const TPoint &p2);


    /**
     * Setup a graphic element for a column listbox using aknlayout.dll
     */
    IMPORT_C static void SetupListboxPos(CEikListBox& aListBox, 
				   const TAknWindowLineLayout &aLayout);
    };

/**
* General utilities relating to listboxes
*
* @since Series 60 0.9
*/
class AknListBoxUtils
    {
public:
    /**
    * This function is similar to @c HandleItemRemovalL(). This function has
    * to call when the items should be removed. If a leave occurs the framework
    * generates a Symbian Leave code.
    * @param aListBox A pointer to @c CEikListBox object.
    * @param aValueOfCurrentItemIndexBeforeRemoval A current item index value 
    * before removal.
    * @param aCurrentItemWasRemoved @c ETrue if removed @c EFalse if not.
    */
    IMPORT_C static void HandleItemRemovalAndPositionHighlightL(CEikListBox *aListBox, TInt aValueOfCurrentItemIndexBeforeRemoval, TBool aCurrentItemWasRemoved);
    
    /**
    * This function should be called after one or more items have been removed.
    * If a leave occurs the framework generates a Symbian Leave code. 
    * @param aListBox A pointer to @c CEikListBox object.
    * @param aValueOfCurrentItemIndexBeforeRemoval A current item index value 
    * before removal.
    * @param aIndexesToRemovedItems A thin templated base class for arrays of
    * fixed length objects.
    */
    IMPORT_C static void HandleItemRemovalAndPositionHighlightL(CEikListBox *aListBox, TInt aValueOfCurrentItemIndexBeforeRemoval, CArrayFix<TInt> &aIndexesToRemovedItems);

    /** 
    * @deprecated
    */
    IMPORT_C static TBool ListBoxLinesShown(MAknsSkinInstance *aInstance, MAknsControlContext *aCc);
    };

#endif