/*

* 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:

*

*/

#ifndef MMMWIDGETCONTAINER_H

#define MMMWIDGETCONTAINER_H

// INCLUDES

#include <AknDef.hrh>

#include <e32std.h>

#include <e32base.h>

#include <eiklbx.h>

#include <coecntrl.h>

#include <AknsDrawUtils.h>

#include <AknsLayeredBackgroundControlContext.h>

#include <AknsListBoxBackgroundControlContext.h>

#include <aknlongtapdetector.h>

#include "hnsuiteobserver.h"

#include "mmvisibilityobserver.h"

#include "hnglobals.h"

// CLASS DECLARATION

class CHnSuiteModel;

class CMmListBoxModel;

class MEikListBoxObserver;

class MMmKeyEventObserver;

class MMmDragAndDropObserver;

class MMmWidgetObserver;

class CMatrixMenuAppUi;

class CMmHighlightTimer;

class CMmMarqueeAdapter;

class CMmListBoxItemDrawer;

class CMmTemplateLibrary;

class CMmPostEvaluationProcessor;

class MMmLongTapObserver;

/**

 * Square of the distance the cursor has to be dragged from the current

 * position to really move the dragged item.

 */

const TInt KDragDelta( 640 );

/**

 * Structure used to store cache for widget position.

 *

 * @since S60 v5.0

 * @ingroup group_mmwidgets

 */

class TMmWidgetPosition

	{

public:

    /**

     * Default constructor.

     * Initializes member variables with sensible values.

     */

    TMmWidgetPosition();

public: // data

	/**

	 * The vertical item offset cache.

	 */

	TInt iVerticalItemOffset;

	/**

	 * The top item index cache.

	 */

	TInt iTopItemIndex;

	/**

	 * Tells if the cached values are valid.

	 */

	TBool iValid;

	/**

	 * The mode (portrait/landscape) for which the cache is valid.

	 */

	TBool iLandscape;

	/**

	 * Id from model (not index) of the currently highlighted item.

	 * It should only be set if the currently highlighted item is

	 * visible (fully or partially), otherwise it must remain

	 * initialized to KErrNotFound.

	 */

	TInt iHighlightedItemId;

	};

/**

 *  Interface for widget containers.

 *

 *  @code

 *  @endcode

 *  @lib mmwidgets

 *  @since S60 v3.0

 *  @ingroup group_mmwidgets

 */

NONSHARABLE_CLASS( CMmWidgetContainer ): public CCoeControl,

                                         public MMmVisibilityObserver,

                                         public MEikListBoxObserver,

                                         public MAknLongTapDetectorCallBack

	{

public:

    /**

     * Creates a new grid container.

     *

     * @since S60 v3.0

     * @param aRect Parent rectangle.

     * @param aObjectProvider Object provider.

     * @return GridContainer.

     */

     IMPORT_C static CMmWidgetContainer* NewGridContainerL( const TRect& aRect,

            MObjectProvider* aObjectProvider, CMmTemplateLibrary* aTemplateLibrary );

    /**

     * Creates a new listbox container.

     *

     * @since S60 v3.0

     * @param aRect Parent rectangle.

     * @param aObjectProvider Object provider.

     * @param aTemplateLibrary Template library for drawer.

     * @return ListboxContainer.

     */

     IMPORT_C static CMmWidgetContainer* NewListBoxContainerL( const TRect& aRect,

            MObjectProvider* aObjectProvider, CMmTemplateLibrary* aTemplateLibrary );

public: // Highlight related methods

	/**

	 * Sets the default highlight.

	 *

     * @since S60 v3.0

     * @param aRedraw Is highlight to redraw.

     */

	virtual void SetDefaultHighlightL( TBool aRedraw = ETrue ) = 0;

    /**

     * Sets the highlight.

     *

     * @since S60 v3.0

     * @param aItemIndex Index to set the highlight at.

     * @param aRedraw Is highlight to redraw.

     */

	IMPORT_C virtual void SetManualHighlightL(TInt aItemIndex,  TBool aRedraw = ETrue );

    /**

     * Gets the highlight from the widget.

     *

     * @since S60 v3.0

     * @return Current Highlight in the widget.

     */

	IMPORT_C virtual TInt GetHighlight();

    /**

     * Gets the highlight from the widget.

     *

     * @since S60 v3.0

     * @return Previous Highlight in the widget.

     */

	IMPORT_C virtual TInt GetPreviousHighlight();

    /**

     * Set highlight visibility.

     *

     * @since S60 v3.0

     * @param aVisible Visibility status.

     */

	IMPORT_C virtual void SetHighlightVisibilityL( TBool aVisible );

    /**

     * Set highlight visibility.

     *

     * @since S60 v3.0

     * @return Visibility status.

     */

	IMPORT_C virtual TBool IsHighlightVisible();

    /**

     * Handle item addition.

     *

     * @since S60 v3.0

     */

	IMPORT_C virtual void HandleItemAdditionL();

    /**

     * Handle item removal.

     *

     * @since S60 v3.0

     */

	IMPORT_C virtual void HandleItemRemovalL();

    /**

     * Handle item removal.

     *

     * @since S60 v3.0

     */

	IMPORT_C CHnSuiteModel* GetSuiteModelL();

    /**

     * Retrieve type of widget.

     *

     * @since S60 v3.0

     * @return Type of widget.

     */

	IMPORT_C virtual THnSuiteWidgetType WidgetType();

	/**

	 * Removes all LIW objects owned by this object.

     *

     * LIW objects owned by non-LIW objects that are owned by

     * this object are also removed.

	 */

	virtual void RemoveLiwObjects();

	/**

	 * Sets the long tap observer.

     *

     * @param aObserver Observer to receive long tap events.

	 */

	IMPORT_C virtual void SetLongTapObserver( MMmLongTapObserver* aObserver );

	/**

	 * Informs the container that long tap event is finished (e.g. because 

	 * a command from the context menu has been issued).

	 * 

	 * @param aStopTimer ETrue when the highlight timer should be stopped.

	 */

	IMPORT_C virtual void EndLongTapL( TBool aStopTimer = ETrue );

public:

	/**

	 * Sets suite model.

	 *

	 * @since S60 v3.0

	 * @param aModel Suite model.

	 */

	virtual void SetSuiteModelL( CHnSuiteModel* aModel );

    /**

     * Gets Multimedia Menu model.

     *

     * @since S60 v3.0

     * @return Model.

     */

	virtual CMmListBoxModel* GetMmModel() = 0;

    /**

     * Sets widget observer.

     *

     * @since S60 v3.0

     * @param aObserver Widget observer.

     */

	IMPORT_C virtual void SetObserver( MMmWidgetObserver*  aObserver);

    /**

     * Gets item rectangle according to item index.

     *

     * @since S60 v3.0

     * @param aItemIndex Item index.

     * @return Item rectangle.

     */

    IMPORT_C TRect GetItemRectL( TInt aItemIndex );

    /**

     * Sets empty text visible when model has no items.

     *

     * @since S60 v3.0

     * @param aText Text to be shown when view is empty.

     */

	virtual void SetEmptyTextL(const TDesC& aText) = 0 ;

    /**

     * Sets flag.

     *

     * @since S60 v3.0

     * @param Flag Flag.

     */

	virtual void SetFlag(TInt Flag);

    /**

     * Gets widget.

     *

     * @since S60 v3.0

     * @return Widget.

     */

	virtual CEikListBox* Widget();

    /**

     * Sets background context for item drawer and view.

     *

     * @since S60 v3.0

     * @param aBgContext Background context.

     */

	virtual void SetItemDrawerAndViewBgContext(

			CAknsBasicBackgroundControlContext * aBgContext ) =0;

    /**

     * Sets edit mode so UI is aware.

     *

     * @since S60 v3.0

     * @param aIsEditMode Is edit mode.

     */

	virtual void SetEditModeL( TBool aIsEditMode );

    /**

     * Tells if UI is aware of edit mode.

     *

     * @since S60 v5.0

     * @return Edit mode status.

     */

	virtual TBool IsEditMode() const;

    /**

     * Sets up widget layout (needed for grid).

     *

     * @since S60 v3.0

     */

	virtual void SetupWidgetLayoutL() =0;

    /**

     * Constructor.

     */

	CMmWidgetContainer();

    /**

     * Destructor.

     */

    ~CMmWidgetContainer();

    /**

     * Enables/disables animation during long tap.

     * Tactile feedback is also enabled and disabled with the animation.

     * Changes made with this method will be effective on the next long

     * tap, i.e. it is not possible to stop an already started animation

     * by using this method.

     * 

     * @param aEnable ETrue - enable, EFalse - disable long tap animation

     *                and long tap tactile feedback

     */

    IMPORT_C void EnableLongTapAnimation( TBool aEnable );

    /**

     * from CCoeControl.

     *

     * @since S60 v3.0

     */

    void SizeChanged();

    /**

     * Draws the widget.

     *

     * @since S60 v3.0

     * @param aRect Rectangle within the widget shuld be drawn.

     */

    void Draw(const TRect& aRect) const;

    /**

      * Draws the widget view.

      *

      * @since S60 v5.0

      */

    virtual void DrawView() = 0;

    /**

     * Returns type UID pointer that can be used in MopSupplyObject.

     *

     * @since S60 v3.0

     * @param aId Type UID, should be the same that was given as aId.

     * parameter of MopSupplyObject.

     * @return Type UID pointer.

     */

    TTypeUid::Ptr MopSupplyObject(TTypeUid aId);

    /**

     * From CCoeControl.

     *

     * @since S60 v3.0

     * @param aPointerEvent Pointer event.

     */

    void HandlePointerEventL(const TPointerEvent& aPointerEvent);

    /**

     * From CCoeControl.

     *

     * @since S60 v5.0

     * @param aPointerEvent Pointer event.

     */

    void HandlePointerEventsInEditModeL(const TPointerEvent& aPointerEvent,

    		TBool aAbortAnimations );

    /**

     * Set draggable.

     *

     * @since S60 v3.0

     * @param aDraggable Is draggable.

     */

    void SetDraggableL( TBool aDraggable );

    /**

     * Gets draggable status.

     * Draggable status determines if the item has

     * the capability to be dragged at the momont.

     * So before threshold is crossed the container

     * is not draggable in the sense of this method

     * because the dragged item is not yet drawn.

     * It becomes draggable when it start to be drawn

     *

     * @since S60 v3.0

     * @return Is draggable.

     */

    IMPORT_C TBool IsDraggable();

    /**

     * From CCoeControl.

     *

     * @since S60 v3.0

     * @return count component controls.

     */

    TInt CountComponentControls() const;

    /**

     * From CCoeControl.

     *

     * @since S60 v3.0

     * @param aIndex index of control.

     * @return component control.

     */

    CCoeControl* ComponentControl(TInt aIndex) const;

    /**

     * From CCoeControl.

     *

     * @since S60 v3.0

     * @param aKeyEvent key event.

     * @param aType event type.

     * @return response to key event.

     */

    TKeyResponse OfferKeyEventL(const TKeyEvent &aKeyEvent, TEventCode aType);

    /**

     * Zooms item icon.

     *

     * @since S60 v3.0

     * @param aItemIndex Item index.

     */

    IMPORT_C void ItemIconZoomL( TInt aItemIndex );

    /**

     * Handle button up event.

     *

     * @since S60 v3.0

     * @param aPointerEvent Pointer event.

     */

    void HandleButtonDownL(const TPointerEvent& aPointerEvent );

    /**

     * Handle button down event.

     *

     * @since S60 v3.0

     * @param aPointerEvent Pointer event.

     */

    void HandleButtonUpL(const TPointerEvent& aPointerEvent );

    /**

     * Overridden to invalidate item drawer cache on skin change and

     * dynamic variant switch.

     *

     * @param aType A message UID value.

     */

    void HandleResourceChange( TInt aType );

    /**

     * Handle dragging of item.

     *

     * @since S60 v3.0

     * @param aPointerEvent Pointer event.

     * @param aAbortAnimation Should animation be aborted.

     */

    void HandleDragL(const TPointerEvent& aPointerEvent, TBool aAbortAnimation );

    /**

     * Sets marquee adapter.

     *

     * @since S60 v3.0

     * @param aAdapter A marquee adapter.

     */

    void SetMarqueeAdapter( CMmMarqueeAdapter* aAdapter );