/*

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

*

* Description:

* Declares main container control for Widget Manager application.

*

*/

#ifndef WMMAINCONTAINER_H

#define WMMAINCONTAINER_H

#include <e32base.h>

#include <e32cmn.h>

#include <f32file.h>

#include <coecobs.h>

#include <coecntrl.h>

#include <AknsUtils.h>

#include <gulicon.h>

#include <eiklbo.h>  // MEikListBoxObserver

// FORWARD DECLARATIONS

class CWmPlugin;

class CWmListBox;

class CAknsBasicBackgroundControlContext;

class CAknViewAppUi;

class CAknSearchField;

class CAknButton;

class CCoeControl;

class CAknSearchField;

class CWmWidgetLoaderAo;

/**

 * Container class for WmMainContainer

 * 

 * @class	CWmMainContainer WmMainContainer.h

 */

NONSHARABLE_CLASS( CWmMainContainer ) : public CCoeControl,

                                        public MEikListBoxObserver,

                                        public MCoeControlObserver

	{

public: // constructors and destructor

    /*

     * Two-phased constructor.

     * 

     * @param aRect container rect

     * @param aParent control base class 

     * @param aCommandObserver observers respond to user commands

     * @param aWmPlugin wm plugin

     */

	static CWmMainContainer* NewL( 

		const TRect& aRect, 

		const CCoeControl* aParent,

		MEikCommandObserver* aCommandObserver,

		CWmPlugin& aWmPlugin );

    /*

     * Two-phased constructor.

     * 

     * @param aRect container rect

     * @param aParent control base class 

     * @param aCommandObserver observers respond to user commands

     * @param aWmPlugin wm plugin

     */

	static CWmMainContainer* NewLC( 

		const TRect& aRect, 

		const CCoeControl* aParent, 

		MEikCommandObserver* aCommandObserver,

		CWmPlugin& aWmPlugin );	

	 /** Destructor */

	virtual ~CWmMainContainer();

private:

	CWmMainContainer( CWmPlugin& aWmPlugin );

    void ConstructL( 

            const TRect& aRect, 

            const CCoeControl* aParent, 

            MEikCommandObserver* aCommandObserver );

public: // new functions	

    /** 

     * @return true, if portal button is currently selected 

     */

    TBool PortalSelected();

    /** 

     * @return true, if a widget in list is currently selected 

     */

    TBool WidgetSelected();

    /** 

     * @return true, ADD command is possible

     */

    TBool CanDoAdd(); 

    /** 

     * @return true, if UNINSTALL command is possible

     */

    TBool CanDoUninstall();

    /** 

     * @return true, if LAUNCH command is possible

     */

    TBool CanDoLaunch();

    /**

     * @return true, if FIND command is possible

     */

    TBool CanDoFind();

    /**

     * @return true, if SORT command is possible

     */

    TBool CanDoSort();

    /**

     * @return true, if DETAILS command is possible

     */

    TBool CanDoDetails();

    /**

     * @return true, if HELP command is possible

     */

    TBool CanDoHelp();

    /** 

     * executes widget details dialog launch 

     */

    void LaunchDetailsDialogL();

    /** 

	 * executes widget addition to home screen 

	 */

	void AddWidgetToHomeScreenL();

	/** 

	 * executes widget launch 

	 */

	void LaunchWidgetL();

	/** 

	 * executes findbox activation 

	 */

	void ActivateFindPaneL();

    /** 

	 * executes findbox deactivation 

	 */

    void DeactivateFindPaneL();

    /** 

     * sorts the widget list in alphabetical order

     */

    void SortListAlphabeticallyL();

	/** 

	 * executes widget uninstall 

	 */

	void UninstallWidgetL();

    /**

     * opens OVI portal

     */

    void OpenOviPortalL();

    /**

     * Selection key (middle soft key)

     */

    void SelectL();

    /**

     * Show widget manager help

     */

    void ShowHelpL();

    /** 

     * handles situation when widget list has changed.

     * in practice reloads the widget list from the widgets API

     * and redraws the screen.

     */

	void HandleWidgetListChanged();

public:

    /**

     * Handles key events.

     * 

     * @see CCoeControl::OfferKeyEventL

     */

	TKeyResponse OfferKeyEventL( 

			const TKeyEvent& aKeyEvent, 

			TEventCode aType );

	/**

	 * Handles a change to the control's resources

	 * 

	 * @see CCoeControl::HandleResourceChange

	 */

	void HandleResourceChange( TInt aType );

	/**

	 * Handles pointer events.

	 * 

	 * @see CCoeControl::HandlePointerEventL

	 */

	void HandlePointerEventL( const TPointerEvent& aPointerEvent );

	/**

	 * returns whether adding of widget was sucessful or not 

	 */

	TInt ExitStatus();

	/**

     * Sets the exit status to denote the failure or sucess of adding

     * widget to homescreen

     */

	void SetExitStatus( TInt aExitStatus );

	/**

	 * Moves focus to the OVI button

	 */

    void SetFocusToOviButton();

    /**

     * Moves focus to the widgets list, alternatively also setting the currently

     * selected item.

     * @param aIndex the item in widgets list to highlight during setting focus.

     *        By default the previously selected item will be highlighted.

     */

    void SetFocusToWidgetList( TInt aIndex = KErrUnknown );

    /*

     * Tells if user inputs should be handeled or not. If ret is EFalse wm 

     * can ignore user inputs. This is becouse closing view is async and user

     * might give some inputs before view is closed. 

     */

    TBool ClosingDown();

    /*

     * To set iClosingDown. See above.

     */

    void SetClosingDown( TBool aClosingDown );

protected: // from base class CCoeControl

    /**

     * Sets the control's extent, specifying a rectangle.

     * 

     * @see CCoeControl::SizeChanged

     */

    void SizeChanged();

private: // from base class CCoeControl

    /*

     * Draws the control.

     * 

     * @see CCoeControl::Draw

     */

    void Draw( const TRect& aRect ) const;

    /**

    * Suppy Mop object for control context

    * @param TTypeUid aId

    */

    TTypeUid::Ptr MopSupplyObject(TTypeUid aId);

private: // from MEikListBoxObserver

    /**

     * List box observer interface.

     * 

     * @see MEikListBoxObserver::HandleListBoxEventL

     */

    void HandleListBoxEventL(

                        CEikListBox* aListBox,

                        TListBoxEvent aEventType);

private: // from MCoeControlObserver

    /**

     * Control observer interface

     * 

     * @see MCoeControlObserver::HandleControlEventL

     */

    void HandleControlEventL(CCoeControl* aControl,TCoeEvent aEventType);

private: // New functions

    void AddControlL( CCoeControl* aControl, TInt aControlId );

    void InitializeControlsL( const TRect& aRect );

    void LayoutControlsL();

    void StartLoadingWidgetsL();

    void RemoveCtrlsFromStack();

    TKeyResponse MoveFocusByKeys(

            const TKeyEvent& aKeyEvent, 

            TEventCode aType );

    void UpdateFocusMode();

    CCoeControl* FindChildControlByPoint( const TPoint& aPoint );

    void HandleFindSizeChanged();

private:

    /**

     * the plugin root

     */

    CWmPlugin&              iWmPlugin;

    /**

     * parent control

     */

    const CCoeControl*      iParent;    

    /**

     * the widgets list

     */

    CWmListBox*             iWidgetsList;

    /**

	 * search filed

	 */

    CAknSearchField* 		iFindbox;

    /**

	 * search filed visibility switch

	 */

    TBool            		iFindPaneIsVisible;

    /**

     * background

     */

    CAknsBasicBackgroundControlContext* iBgContext;

    /**

     * Ovi portal

     */

    CAknButton*             iOviPortal;

    /** GUI layout modes */

    enum TWmLayout

        {

        EPortrait,

        ELandscape,

        ELandscapeMirrored

        };

    /**

     * current widget manager container layout

     */

    TWmLayout               iLayout;

    /** focus modes */

    enum TWmFocusMode

        {

        ENowhere,

        EOvi,

        EList,

        EFind

        };

    /**

     * current widget manager focus mode

     */

    TWmFocusMode            iFocusMode;

	/**

     * exit variable to denote sucess or failure of adding widget to hs

     */

    TInt                    iExitStatus;

    /**

     * AO for loading widgets into the list UI

     */

    CWmWidgetLoaderAo*      iWidgetLoader;

    /**

     * If this is set to ETrue it means wmview is closing and all user inputs

     * should be ignored.

     */

    TBool                   iClosingDown;

    };

#endif // WMMAINCONTAINER_H

// End of File