/*

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

*

*

*/

#ifndef CCAPPCOMMLAUNCHERCUSTOMLISTBOXDATA_H_

#define CCAPPCOMMLAUNCHERCUSTOMLISTBOXDATA_H_

#include <e32base.h>

#include <gdi.h>

#include <eiklbd.h>

#include <eikfrlb.h>

#include <avkon.hrh>

#include <babitflags.h>    // for TBitFlags32

class CWindowGc;

class CGulIcon;

class CCCAppCommLauncherCustomListBoxDataExtension;

class MAknsControlContext;

class TAknsItemID;

class CAknLayoutData;

class CAknsEffectAnim;

class TAknTextLineLayout;

class TAknWindowLineLayout;

class TAknTextComponentLayout;

class TAknWindowComponentLayout;

class CCCAppCommLauncherCustomListBoxData : public CListBoxData

    {

    friend class CCCAppCommLauncherCustomListBoxDataExtension;

public:

    //INNER CLASS DECLARATION

    /*

     * A container class for storage of colour values.                           

     * Used by @c CFormattedCellListBoxData.

     */

    class TColors

        {

    public:

        /**

         * C++ default constructor.

         */

         TColors();

    public:

        /** 

         * The text colour.

         */

        TRgb iText;

        /** 

         * The background colour.

         */

        TRgb iBack;

        /** 

         * The highlighted text colour.

         */

        TRgb iHighlightedText;

        /** 

         * The highlighted background colour.

         */

        TRgb iHighlightedBack;

        /** 

         * The separator line colour.

         *

         * @deprecated The separator line colour is no longer used because the

         *             separator lines are skinned.

         */

        TRgb iRightSeparatorColor;

        };

public:

    /**

     * Two-phased constructor.

     *

     * @return Pointer to a new formatted cell listbox data object.

     */

     static CCCAppCommLauncherCustomListBoxData* NewL();

    /**

     * Destructor.

     */

     ~CCCAppCommLauncherCustomListBoxData();

public:

    /**

     * Gets colours attached to the cell.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @return Text and background colors.

     */

     const TColors& SubCellColors(TInt aSubCellIndex) const;

    /**

     * Sets colours attached to the cell.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @param aColors Text and background colors.

     */

     void SetSubCellColorsL(TInt aSubCellIndex, const TColors &aColors);

    /**

     * Gets baseline position from top of the cell.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @return Baseline y-position.

     */

     TInt SubCellBaselinePos(TInt aSubCellIndex) const;

    /**

     * Sets baseline position from top of the cell.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @param aPos Position which is set for the item.

     */

     void SetSubCellBaselinePosL(TInt aSubCellIndex, TInt aPos);

    /**

     * Gets cell size in pixels.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @return Cell size.

     */

     TSize SubCellSize(TInt aSubCellIndex) const;

    /**

     * Sets cell size in pixels.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @param aSize Cell size.

     */

     void SetSubCellSizeL(TInt aSubCellIndex, TSize aSize);

    /**

     * Gets cell position inside an item.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @return Cell position.

     */

     TPoint SubCellPosition(TInt aSubCellIndex) const;

    /**

     * Sets cell position inside an item.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @param aPosition New position for cell.

     */

     void SetSubCellPositionL(TInt aSubCellIndex, TPoint aPosition);

    /**

     * Determines whether this cell can overlap with one of the previous cells.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @return @c ETrue if cell overlaps another one, @c EFalse if cell allocates 

     *         area from other cells.

     */

     TBool SubCellIsTransparent(TInt aSubCellIndex) const;

    /**

     * Modifies whether the cell can overlap with one of the previous cells.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @param aIsTransparent @c ETrue if transparent, @c EFalse if not.

     */

     void SetTransparentSubCellL(TInt aSubCellIndex, 

                                         TBool aIsTransparent);

    /**

     * Checks whether drawing algorithm always draws the cell or whether empty 

     * string in list item can disable the drawing of the cell.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @return @c ETrue when empty string disables cell, 

     *         @c EFalse if always drawn.

     */

     TBool SubCellIsNotAlwaysDrawn(TInt aSubCellIndex) const;

    /**

     * Sets whether drawing algorithm always draws the cell.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @param aIsNotAlwaysDrawn If @c ETrue, empty string disables cell.

     */

     void SetNotAlwaysDrawnSubCellL(TInt aSubCellIndex,

                                            TBool aIsNotAlwaysDrawn);

    /**

     * Gets margins used for the content inside the cell.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @return Margins in pixels.

     */

     TMargins SubCellMargins(TInt aSubCellIndex) const;

    /**

     * Sets margins for the content inside the cell.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @param aMargins Margins for the content inside the cell.

     */

     void SetSubCellMarginsL(TInt aSubCellIndex, TMargins aMargins);

    /**

     * Gets font attached to the cell.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @return Handle to the attached font.

     */

     const CFont* SubCellFont(TInt aSubCellIndex) const;

    /**

     * Sets the font attached to the cell.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @param aFont Font to attach to the cell.

     */

     void SetSubCellFontL(TInt aSubCellIndex, const CFont* aFont);

    /**

     * Gets the alignment attached to the cell.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @return Alignment of the text.

     */

     CGraphicsContext::TTextAlign SubCellAlignment(TInt aSubCellIndex)

        const;

    /**

     * Sets the alignment attached to the cell.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @param aAlign Alignment that is attached to the cell

     */

     void SetSubCellAlignmentL(TInt aSubCellIndex,

                                       CGraphicsContext::TTextAlign aAlign);

    /**

     * Checks whetherdrawing algorithm considers the text

     * string in list item as unicode text string displayable on the screen,

     * or as string representation of an index to icon array.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @return @c ETrue if graphics cell, @c EFalse if text cell.

     */

     TBool SubCellIsGraphics(TInt aSubCellIndex) const;

    /**

     * Sets whether drawing algorithm considers the text string in list item as

     * unicode text string displayable on the screen, or as string 

     * representation of an index to icon array.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @param aIsGraphics @c ETrue if graphics cell, @c EFalse if text cell.

     */

     void SetGraphicsSubCellL(TInt aSubCellIndex, TBool aIsGraphics);

    /**

     * Checks whether vertical line is drawn to the right side of the cell.

     *

     * @param aColumn Index number of the subcell.

     * @return Style of pen used to draw a line for the right side of the cell.

     */

     CGraphicsContext::TPenStyle 

        SubCellRightSeparatorStyle(TInt aColumn) const;

    /**

     * Sets whether vertical line is drawn to the right side of the cell.

     *

     * @param aSubCell Index number of the subcell.

     * @param aStyle Style of a pen used to draw a line for the right side of 

     *        the cell.

     */

     void SetSubCellRightSeparatorStyleL(TInt aSubCell,

                                            CGraphicsContext::TPenStyle aStyle);

    /**

     * Gets the amount of pixels text margins is grown if it is truncated. 

     * This is usually very small number used to make the layout look more 

     * balanced when text is truncated. (the glyph used for truncation is 

     * almost empty and on narrow text elements, it looks odd if the truncated

     * text element is exactly same size as non-truncated version.)

     *

     * @param aSubCellIndex Index number of the subcell.

     * @return Amount of pixels that are used for growing the text margins in 

     *         truncation.

     */

     TInt SubCellTextClipGap(TInt aSubCellIndex) const;

    /**

     * Sets the amount of pixels truncation grows a text element.

     *

     * @param aSubCellIndex Index number of the subcell.

     * @param aGap The amount of pixels that are required for growing the text 

     *        element when it is truncated. 

     */

     void SetSubCellTextClipGapL(TInt aSubCellIndex, TInt aGap);

    /**

     * SkinEnabled checks whether skins are enabled on this list.

     *

     * @since Symbian 2.0 

     * @return @c ETrue if enabled, @c EFalse if disabled.

     */

     TBool SkinEnabled() const;

    /**

     * Sets whether skins are enabled on this list.

     * The default value is determined from global setting from @c CAknAppUi.

     *

     * @since Symbian 2.0

     * @param aEnabled If @c ETrue skins are set enabled. 

     *        If @c EFalse skins are set disabled.

     */

     void SetSkinEnabledL(TBool aEnabled);

    /**

     * Checks whether the cell is used for numbers.

     *

     * @since Symbian 2.0

     * @param aSubCellIndex Index number of the subcell.

     * @return @c ETrue if enabled, @c EFalse if disabled.

     */

     TBool SubCellIsNumberCell(TInt aSubCellIndex) const;

    /**

     * Sets whether the cell is used for numbers.

     *

     * @since Symbian 2.0

     * @param aSubCellIndex Index number of the subcell.

     * @param aIsNumberCell New value for the flag.

     */

     void SetNumberCellL(TInt aSubCellIndex, TBool aIsNumberCell);

    /**

     * Gets the icon array used when drawing bitmaps for the listbox items.

     */

     CArrayPtr<CGulIcon>* IconArray() const;

    /**

     * Sets the icon array used when drawing bitmaps.

     * The array can be modified (no need to call this method when modifying),

     * even in @c MdcaPoint() or @c MdcaCount() methods of @c MDesCArray class.

     * See also @c CTextListBoxModel::SetItemTextArray().

     * 

     * The most common way to crash a listbox is by forgetting to call this 

     * method, or the list item string for graphics cell is not an index of 

     * a bitmap.

     *

     * @param aArray Pointer to the icon array.

     */

     void SetIconArrayL(CArrayPtr<CGulIcon>* aArray);

    /**

     * SetIconArray sets the icon array used when drawing bitmaps.

     * The array can be modified (no need to call this method when modifying),

     * even in @c MdcaPoint() or @c MdcaCount() methods of @c MDesCArray class.

     * See also @c CTextListBoxModel::SetItemTextArray().

     * 

     * The most common way to crash a listbox is by forgetting to call this

     * method, or the list item string for graphics cell is not an index of

     * a bitmap.

     *

     * @param aArray Pointer to the icon array.

     */

     void SetIconArray(CArrayPtr<CGulIcon>* aArray);

    /**

     * Font access to the font used in subcell.

     *

     * @param aItemProperties Not used in code.

     * @param aSubCellIndex Index number of the subcell.

     * @return Font used in subcell.

     */

     CFont* Font(const TListItemProperties& aItemProperties,

                         TInt aSubCellIndex) const;

    /**

     * From @c CListBoxData.

     *

     * @c Draw() is the most important method in 

     * @c CEikFormattedCellListBoxData.

     * This is the only method that needs to be implemented in this class and

     * it draws the whole list item.

     *

     * @param aProperties Properties attached to the list item.

     * @param aGc Graphics Context used for drawing the list item.

     * @param aText A text string describing the list item cells.

     * @param aRect The area of the screen for the whole list item.

     * @param aHighlight Whether the list item is selected.

     * @param aColors The colours used for drawing the item.

     */

     virtual void Draw(TListItemProperties aProperties,

                               CWindowGc& aGc,

                               const TDesC* aText,

                               const TRect& aRect,

                               TBool aHighlight,

                               const TColors& aColors) const;

    /**

     * Indicates if sub cell is using its own colors rather than common colors.

     *

     * @param aSubCell Index number of the subcell.

     * @return Boolean indicating whether own colors enabled.

     *         @c ETrue enabled, @c EFalse disabled.

     */

     TBool UseSubCellColors(TInt aSubCell) const;

    /**

     * Ability for a skin subsystem to access Mop chain through current 

     * listbox control.

     *

     * @since Symbian 2.0

     * @return Current listbox instance or NULL.

     */

     CCoeControl* Control() const;

    /**

     * Ability for a skin subsystem to access mop chain through current listbox

     * control.

     *

     * @since Symbian 2.0

     * @param aControlOrNull Current listbox instance or NULL. Cannot be other

     *        control than the current listbox!

     */

     void SetControl(CCoeControl* aControlOrNull);

    /**

     * Access to the background context of the listbox.

     *

     * @since Symbian 2.0

     * @return Skin background context.

     */

     MAknsControlContext* SkinBackgroundContext() const;

    /**

     * Modify properties of the skin context (background).

     *

     * @since Symbian 2.0

     * @param aId Skin background identifier.

     * @param aRect Skin background rectangle.

     */

     void SetBackgroundSkinStyle(const TAknsItemID *aId,

                                         const TRect &aRect);

    /**

     * Modify properties of the skin context (AB-column).

     *

     * @since Symbian 2.0

     * @param aId Skin background identifier.

     * @param aTileRect Skin background area from LAF.

     */

     void SetSkinStyle(const TAknsItemID* aId, const TRect& aTileRect);

    /**

     * Modify position of the parent for list default context.

     *

     * @since Symbian 2.0

     * @param aPos The new position.

     */

     void SetSkinParentPos(const TPoint& aPos);

    /**

     * Modify properties of the skin context (list ending)*

     * @since Symbian 2.0

     * @param listEndId List ending skin background identifier.

     * @param aRect List ending background area from LAF.

     */

     void SetListEndSkinStyle(const TAknsItemID *listEndId,

                                      const TRect &aRect);

    /**

     * Gets RespectFocus flag.

     *

     * @return RespectFocus flag. @c ETrue if list item highlights are only 

     *         shown  when the list is has been focused on.

     */

     TBool RespectFocus() const;

    /**

     * Sets RespectFocus flag.

     *

     * @param aBool Value of RespectFocus flag. @c ETrue means that the 

     *        list item highlight is only shown if list is focused on.

     */

     void SetRespectFocus(TBool aBool);

    /**

     * Set list higlight skin style.

     *

     * @since Symbian 2.0

     * @param aFrameId The id for the frame.

     * @param aFrameCenterId The id for the frame center.

     */

     void SetSkinHighlightFrame(const TAknsItemID* aFrameId,

                                        const TAknsItemID* aFrameCenterId);

    /**

     * Set popup skin style.

     *

     * @since Symbian 2.0

     * @param aFrameId The id for the frame.