/*

* 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 <liwgenericparam.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 );

    /**

     * Sets up item drawer.

     *

     * @since S60 v3.0

     */

    void SetupDrawer();

    /**

     * Cancels gragging of item.

     *

     * @since S60 v3.0

     * @param aAnimate Should dragged item transition be animated.

     */

    IMPORT_C void CancelDragL( TBool aAnimate );

    /**

     * Animates item shifting.

     *

     * @since S60 v3.0

     * @param aHighlight Highlighted item index.

     */