/*

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

*  Version     : %version: MM_12.1.6 % << Don't touch! Updated by Synergy at check-out.

*

*/

#ifndef MMLISTBOXVIEW_H

#define MMLISTBOXVIEW_H

// INCLUDES

#include <e32std.h>

#include <e32base.h>

#include <eikfrlb.h> 

// CLASS DECLARATION

/**

 *  Multimedia Menu Listbox view.

 *  

 *  @code

 *  @endcode

 *  @lib mmwidgets

 *  @since S60 v3.0

 *  @ingroup group_mmwidgets

 */

NONSHARABLE_CLASS( CMmListBoxView ) : public CFormattedCellListBoxView 

    {

public:

    // Constructors and destructor

    /**

     * Destructor.

     */

    ~CMmListBoxView();

    /**

     * Two-phased constructor.

     */

    static CMmListBoxView* NewL();

    /**

     * Two-phased constructor.

     */

    static CMmListBoxView* NewLC();

	/**

	 * Calculate the bottom item index.

	 * 

	 * @since S60 v3.0

	 */

    void CalcBottomItemIndex();

	/**

	 * Draw the view.

	 * 

	 * @since S60 v3.0

	 * @param clipRect Clipping rectangle.

	 */

    void Draw(const TRect* clipRect) const;

	/**

	 * Draws the listbox within the given clipping rect.

	 * 

	 * @since S60 v3.0

	 * @param clipRect Clipping rectangle.

	 */

    void DoDraw(const TRect* aClipRect) const;

	/**

	 * Draw item in view. It is possible that it

	 * calls drawing of more than one item.

	 * 

	 * @since S60 v3.0

	 * @param aItemIndex Item index.

	 */

    void DrawItem(TInt aItemIndex) const;

	/**

	 * Draw a single item in view.

	 * 

	 * @since S60 v3.0

	 * @param aItemIndex Item index.

	 */

    void DrawSingleItem (TInt aItemIndex) const;

	/**

	 * Get the number of items that fit in rectangle.

	 * 

	 * @since S60 v3.0

	 * @param aRect Clipping rectangle.

	 * @return Number of items that fit in rectangle.

	 */

    TInt NumberOfItemsThatFitInRect(const TRect& aRect) const;

	/**

	 * Get the number of items that fit in rectangle (with option to include

	 * partial item at bottom of view).

	 * 

	 * @since S60 v3.0

	 * @param aRect Rect for calculations.

	 * @param aIncludePartialItem Should partial item be included.

	 * @return Number of items that fit in rectangle.

	 */

    TInt GetNumberOfItemsThatFitInRect (const TRect& aRect, TBool aIncludePartialItem ) const;

	/**

	 * Get item size.

	 * 

	 * @since S60 v3.0

	 * @param aItemIndex Item index.

	 * @return Size of item.

	 */

    TSize ItemSize(TInt aItemIndex) const;

	/**

	 * Sets aItemIndex to the index of the item whose bounding box contains aPosition.

	 * 

	 * @since S60 v3.0

	 * @param aPosition Item position.

	 * @param aItemIndex Item index.

	 * @return Was item found.

	 */

    TBool XYPosToItemIndex(TPoint aPosition, TInt& aItemIndex) const;

	/**

	 * Gets item position.

	 * 

	 * @since S60 v3.0

	 * @param aItemIndex Item index.

	 * @return Item position.

	 */

    TPoint ItemPos(TInt aItemIndex) const;

	/**

	 * Sets item height.

	 * 

	 * @since S60 v3.0

	 * @param aItemHeight Item height.

	 */

    void SetItemHeight(TInt aItemHeight);

	/**

	 * Calculates new top item index so item is visible.

	 * 

	 * @since S60 v3.0

	 * @param aItemIndex Item to be visible.

	 * @return New top item index.

	 */

    TInt CalcNewTopItemIndexSoItemIsVisible(TInt aItemIndex) const;

	/**

	 * Draw background between rects.

	 * 

	 * @since S60 v3.0

	 * @param aUsedPortionOfViewRect Inner rect.

	 * @param aSmallerViewRect Outer rect.

	 */

    void RedrawBackground( TRect aUsedPortionOfViewRect, TRect aSmallerViewRect) const;

	/**

	 * Draws background in list which is not covered by vivible items.

	 * 

	 * @since S60 v3.0

	 */

    void RedrawBackground() const;

	/**

	 * Gets total height of items within range.

	 * 

	 * @since S60 v3.0

	 * @param aStartIndex Start item index.

	 * @param aEndIndex End item index.

	 * @return Total height of items starting from aStartIndex, ending with aEndIndex.

	 */

    TInt GetTotalHeight( TInt aStartIndex, TInt aEndIndex ) const;

    /**

     * Gets the current widget vertical item offset.

     * 

     * @since S60 v5.0

     * @return The current widget vertical item offset.

     */

    TInt VerticalItemOffset() const;

    /**

     * Overridden to allow for disabling this method in certain situations.

     * 

     * @param aItemIndex Item index.

     */

    TBool ScrollToMakeItemVisible(TInt aItemIndex);

    /**

     * Disables ScrollToMakeItemVisible.

     * When disabled, ScrollToMakeItemVisible does nothing.

     * 

     * @param aDisable Self-explanatory.

     */

    void DisableScrollToItem( TBool aDisable );

private:

    /**

     * Constructor for performing 1st stage construction.

     */

    CMmListBoxView();

    /**

     * Default symbian 2nd stage constructor.

     */

    void ConstructL();

	/**

	 * Updates average item height.

	 * 

	 * @since S60 v3.0

	 */

   	void UpdateAverageItemHeight();

	/**

	 * Gets last item index depending on height.

	 * 

	 * @since S60 v3.0

	 * @param aStartIndex Start item index.

	 * @param aHeight Height of area.

	 * @return Last item index.

	 */

    TInt GetLastIndexInHeight( const TInt aStartIndex, TInt aHeight ) const;

	/**

	 * Sets the previously drawn current item index.

	 * 

	 * @since S60 v3.0

	 * @param aIndex Current Item index.

	 */

    void SetPreviouslyDrawnCurrentItemIndex( TBool aIndex );

private:

	/**

	 * Scrollbar visibility flag.

	 */

	TBool iScrollbarIsVisible;

	/**

	 * iCurrentItemIndex

	 */

	TInt iPreviouslyDrawnCurrentItemIndex;

	/**

	 * When ETrue, disables ScrollToMakeItemVisible method.

	 */

	TBool iScrollToItemDisabled;

    };

#endif // MMLISTBOXVIEW_H