/*

* Copyright (c) 1997-2009 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:

*

*/

#if !defined(__EIKCLBD_H__)

#define __EIKCLBD_H__

#include <e32base.h>

#include <gdi.h>

#include <eiklbd.h>

#include <avkon.hrh>

#include <babitflags.h>    // for TBitFlags32

class CWindowGc;

class CGulIcon;

class CColumnListBoxDataExtension;

class MAknsControlContext;

class CCoeControl;

class TAknsItemID;

class CAknsEffectAnim;

class CAknsListBoxBackgroundControlContext;

class CAknLayoutData;

class TAknWindowLineLayout;

class TAknTextLineLayout;

class TAknWindowComponentLayout;

class TAknTextComponentLayout;

class MAknsSkinInstance;

/**

* A callback interface for overriding highlight animation input layer

* preparation in derived classes. Usually drawing the background under the

* highlight rect will yield the right kind of result. The size of the render

* target is equal to item cell size.

*

* @since 3.0

*/

class MColumnListBoxAnimBackgroundDrawer

    {

    public:

        /**

         * Draws the background under the current highlight.

         *

         * Should be implemented in the derived class .

         *

         * @param aGc bitmapped graphics context to be drawn.

         * @return @c ETrue if Succeeded.

         */

        virtual TBool DrawHighlightAnimBackground( CFbsBitGc& aGc ) const = 0;

    };

/**

 * The @c CColumnListBoxData class handles the data required to draw a column 

 * list box.

 *

 * The class performs drawing for @c CColumnListBoxItemDrawer. Columns are 

 * numbered from 0 from left to right, and extra column data can be set 

 * for each.

 *

 * N.B.: The standard width of a column drawn by @c CColumnListListBoxData is  

 * 0 pixels, so at the very least a column width should be set for each column 

 * in a column list box.    

 *

 * This class is not intended for user derivation. 

 */

class CColumnListBoxData : public CListBoxData

    {

    friend class CColumnListBoxDataExtension;

public:

    /**

     * Represents the colours used within the border and for the optional 

     * single pixel border outlines.

     *

     * These colours are stored using @c TRgb values.

     */

    class TColors

        {

    public:

        /**

         * C++ default constructor.

         */

        IMPORT_C TColors();

    public:

        /**

         * Stores text Color.

         */

        TRgb iText;

        /**

         * Stores background color.

         */

        TRgb iBack;

        /**

         * Stores highLighted text color.

         */ 

        TRgb iHighlightedText;

        /**

         * Stores highlighted background colour.

         */

        TRgb iHighlightedBack;

        };

public:

    /**

     * Two-phased constructor.

     *

     * Allocates and constructs a column list box data object.

     *

     * Constructs an array in which the column data is held.

     *

     * @return New @c CColumnListBoxData.

     */

    IMPORT_C static CColumnListBoxData* NewL();

    /**

     * Destructor.

     */

    IMPORT_C ~CColumnListBoxData();

public:

    /**

     * Gets the index of the last defined column.

     *

     * @return The index of the last defined column or @c KErrNotFound if no 

     *         column has been defined.

     */

    IMPORT_C TInt LastColumn() const;

    /**

     * Gets the specified column’s width in pixels.

     *

     * @param aColumn The index of the column for which the width is obtained.

     * @return The specified column’s width in pixels. Zero is returned if no 

     *         column exists at the specified index.

     */

    IMPORT_C TInt ColumnWidthPixel(TInt aColumn) const;

    /**

     * Sets the specified column’s width in pixels.

     * 

     * If the column does not exist, one is added at the specified index, 

     * with the specifed width.

     *

     * @param aColumn The index of the column for which the width is to be set.

     * @param aWidth The width in pixels.

     */

    IMPORT_C void SetColumnWidthPixelL(TInt aColumn,TInt aWidth);

    /**

    * Not used in S60.

    */

    IMPORT_C TInt ColumnHorizontalGap(TInt aColumn) const;

    /**

    * Not used in S60.

    */

    IMPORT_C void SetColumnHorizontalGapL(TInt aColumn,TInt aGap);

    /**

     * Gets column's baseline.

     *

     * @param aColumn target column.

     * @return Vertical position.

     */

    IMPORT_C TInt ColumnBaselinePos(TInt aColumn) const;

    /**

     * Sets columns baseline position.

     *

     * @param aColumn Target column.

     * @param aPos Wanted position.

     */

    IMPORT_C void SetColumnBaselinePosL(TInt aColumn,TInt aPos);

    /**

     * Gets column's margins.

     *

     * @param aColumn Target column.

     * @return The columns margins.

     */

    IMPORT_C TMargins ColumnMargins(TInt aColumn) const;

    /**

     * Sets column's margins.

     *

     * @param aColumn Target column.

     * @param aMargins Wanted margins.

     */

    IMPORT_C void SetColumnMarginsL(TInt aColumn,TMargins aMargins);

    /**

     * Gets font used by the column.

     *

     * @param aColumn Target column.

     * @return Used font.

     */

    IMPORT_C const CFont* ColumnFont(TInt aColumn) const;

    /**

     * Sets column's font.

     *

     * @param aColumn Target column.

     * @param aFont Wanted font.

     */

    IMPORT_C void SetColumnFontL(TInt aColumn,const CFont* aFont);

    /**

     * Gets the text alignment for the specified column.

     *

     * @param  aColumn The index of the column for which the alignment 

     *         is obtained.

     * @return The text alignment for the specified column. The default 

     *         is @c ELeft.

     */

    IMPORT_C CGraphicsContext::TTextAlign ColumnAlignment(TInt aColumn) const;

    /**

     * Sets the text alignment for the specified column.

     *

     * If the column does not exist, it is added with the specified index 

     * to the array.

     *

     * @param aColumn The index of the column for which alignment is set.

     * @param aAlign The text alignment to use. The default is @c ELeft.

     */

    IMPORT_C void SetColumnAlignmentL(TInt aColumn,

                                      CGraphicsContext::TTextAlign aAlign);

    /**

    * Not used in S60.

    */

    IMPORT_C CGraphicsContext::TPenStyle ColumnSeparatorStyle(

                                                        TInt aColumn) const;

    /**

    * Not used in S60.

    */

    IMPORT_C void SetColumnSeparatorStyleL(TInt aColumn, 

                                           CGraphicsContext::TPenStyle aStyle);

    /**

     * Checks whether the column is optional.

     *

     * @param aColumn Target column.

     * @return @c ETrue if the column is optional.

     */

    IMPORT_C TBool ColumnIsOptional(TInt aColumn) const;

    /**

     * Sets whether the column is optional.

     *

     * @param aColumn Target column.

     * @param aIsOptional Wanted setting, @c ETrue if column is optional.

     */

    IMPORT_C void SetOptionalColumnL(TInt aColumn,TBool aIsOptional);

    /**

     * Checks whether the column contains graphics.

     *

     * @param aColumn Target column.

     * @return @c ETrue if column contains graphics.

     */

    IMPORT_C TBool ColumnIsGraphics(TInt aColumn) const;

    /**

     * Sets whether the column shows graphics.

     *

     * @param aColumn Target column.

     * @param aIsGraphics Wanted setting.

     */

    IMPORT_C void SetGraphicsColumnL(TInt aColumn,TBool aIsGraphics);

    /**

     * Checks if the column is a number.

     *

     * @param aColumn Target column.

     * @return @c ETrue if it is a number.

     */

    IMPORT_C TBool ColumnIsNumber(TInt aColumn) const;

    /**

     * Sets whether the column is a number. 

     *

     * @param aColumn Target columun.

     * @param aIsNumber Wanted setting. @c ETrue if it is a number.

     */

    IMPORT_C void SetNumberColumnL(TInt aColumn,TBool aIsNumber);

    /**

     * Gets the icon array. 

     *

     * These icons contain the bitmaps that are displayed in graphical columns.

     *

     * @return Pointer to the icon array.

     */

    IMPORT_C CArrayPtr<CGulIcon>* IconArray() const;

    /**

     * Sets icon array.

     *

     * @param aArray Wanted icon collection .

     */

    IMPORT_C void SetIconArray(CArrayPtr<CGulIcon>* aArray);

    /**

     * Gets TextClipGap, the gap between words in a text clip, for the 

     * given column.

     *

     * @param aSubCellIndex Index to target column.

     * @return TextClipGap.

     */

    IMPORT_C TInt ColumnTextClipGap(TInt aSubCellIndex) const;

    /**

     * Sets columns TextClipGap, the gap between words in a text clip.

     *

     * @param aSubCellIndex Index of the target column.

     * @param aSize Wanted TextClipGap size. 

     */

    IMPORT_C void SetColumnTextClipGapL(TInt aSubCellIndex, TInt aSize);

    /**

     * Gets the specified font for the specified column.

     *

     * @param aItemProperties Whether the required font is:

     *        bold, italic, bold and italic or normal.

     * @param aColumn The index of the column for which the font is obtained.

     * @return The specified column’s, specified font. Null, the 

     *         default, if no font is set for the column.

     */

    IMPORT_C CFont* Font(const TListItemProperties& aItemProperties, 

                         TInt aColumn) const;

    /**

     * Gets the specified column’s surrounding rectangle.

     *

     * @param aColumn The index of the column for which the rectangle 

     *                is obtained.

     * @param aRect On return contains the specified column’s rectangle.

     * @return @c ETrue if successful. @c EFalse if a non-existent column 

     *               was specified.

     */

    IMPORT_C TBool MakeColumnRect( TInt aColumn, TRect& aRect );

    /**

     * Draws a single row.

     *

     * The text @c aText is parsed into columns and is split using 

     * @c KColumnListSeparator. Text or bitmaps are drawn according to whether 

     * the column has been set as a graphical column 

     * (see @c SetGraphicsColumnL()). Column cells within the row are drawn 

     * from left to right.

     *

     * @param aItemProperties The properties of each column in the row.

     * @param aGc The graphics context to draw into.

     * @param aText The text to parse and draw.

     * @param aRect Bounding rectangle for the entire row.

     * @param aHighlight @c ETrue to draw the item highlighted. 

     *        @c EFalse otherwise.

     * @param aColors The colours to use if the item is highlighted.

     */

    IMPORT_C virtual void Draw(const TListItemProperties& aItemProperties, 

                               CWindowGc& aGc,

                               const TDesC* aText,

                               const TRect& aRect,

                               TBool aHighlight,

                               const TColors& aColors) const;

    /**

    * internal

    */

    void DrawSimple(const TListItemProperties& aItemProperties, CWindowGc& aGc,const TDesC* aText,const TRect& aRect,TBool aHighlight,const TColors& aColors) const;

    /**

     * Sets position of listbox line.

     *

     * @param aPosition Wanted position.

     */

    IMPORT_C void SetSeparatorLinePosition(

                                        TAknSeparatorLinePosition aPosition);

    /**

     * Gives out separator line position.

     *

     * @return Separator position.

     */

    IMPORT_C TAknSeparatorLinePosition SeparatorLinePosition() const;

    /**

     * 

     * @deprecated

     *

     * Gives out layout data for separator line drawing.

     *

     * @return Requested layout data.

     */

    IMPORT_C CAknLayoutData *LayoutData() const;

    /**

     * 

     * @deprecated

     *

     * Checks if the layout has been initialized.

     *

     * @return @c ETrue if initialized.

     */

    IMPORT_C TBool LayoutInit() const;

    /**

     * 

     * @deprecated

     *

     * Sets the initialization .

     *

     * @param aValue Wanted value (@c ETrue = initialized).

     */

    IMPORT_C void SetLayoutInit(TBool aValue) const;

    /**

     * Enables / disables underlining per text column,

     * if and only if @c TListItemProperties also has underlining enabled.

     * If this method is not called and @c TListItemProperties has underlining

     * enabled, drawing will revert to old style where only first text column

     * will be underlined.

     *

     * @since S60 3.0

     * @param aUnderlinedColumns Bitmask of columns to be underlined.

     */    

    IMPORT_C void SetColumnUnderlined( TBitFlags32 aUnderlinedColumns );

private:

    struct SColumn

        {

        TInt iColumn; // Must be first entry

        TInt iWidth;

        TMargins iMargins;

        TInt iVerticalCap;

        const CFont* iBaseFont;

        TInt iActualFontIndex;

        TBool iGraphics;

    TBool iOptional;

    TInt iBaseline;

        CGraphicsContext::TTextAlign iAlign;

    CGraphicsContext::TPenStyle iSeparator;

    TInt iTextClipGap;

    TBool iNumberColumn;

    // the next are for storing x-coordinates of a column for the drawing algorithm.

    __MUTABLE TInt iX;

    __MUTABLE TInt iEndX;

        };

protected:

    /**

     * C++ default constructor.

     */

    IMPORT_C CColumnListBoxData();

    /**

     * A second phase constructor. 

     *

     * Highlight animation will be created by default (if it is provided 

     * by the skin).

     */

    IMPORT_C void ConstructLD();

    /**

     * Second phase constructor for subclasses that want to override highlight

     * animation creation.

     *

     * @since 3.0

     * @param aAnimationIID Skin item identifier of the constructed animation. 

     *        Passing @c KAknsIIDNone will disable highlight animation.

     */

    IMPORT_C void ConstructLD( const TAknsItemID& aAnimationIID );

private:

    IMPORT_C TInt ColumnX(TInt aColumn) const;

    IMPORT_C void SetColumnXL(TInt aColumn,TInt aX) const; // note, const! (do not affect external state)

    //

    IMPORT_C TInt ColumnEndX(TInt aColumn) const;

    IMPORT_C void SetColumnEndXL(TInt aColumn,TInt aEndX) const; // note, Const!

    void AddColumnL(TInt aColumn);

    SColumn& At(TInt aArrayIndex);

    const SColumn& At(TInt aArrayIndex) const;

    TBool FindColumnIndex(TInt& aArrayIndex,TInt aColumn) const;

    void FindColumnIndexOrAddL(TInt& aArrayIndex,TInt aColumn);

    TInt AddActualFontL(const CFont* aBaseFont);

    void SetUnderlineStyle( TListItemProperties aProperties, CWindowGc& aGc, TInt aColumn ) const;

    void DoConstructL( const TAknsItemID& aAnimationIID );

public:

    /**

     * Gets @c CCoeControl for component.

     *