/*

* Copyright (c) 2006-2008 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the License "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:  Manages widget windows, each window display one widget

*

*/

#ifndef WIDGETUIWINDOWMANAGER_H_

#define WIDGETUIWINDOWMANAGER_H_

// INCLUDES FILES

#include <WidgetRegistryClient.h>

#include <aknglobalconfirmationquery.h>

#include <coecntrl.h>

#include "WidgetUiObserver.h"

#include "Browser_platform_variant.hrh"

// CONSTANTS

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class CDocumentHandler;

class CWidgetUiWindowView;

class CWidgetUiWindow;

class CWidgetUiAppUi;

class CWidgetUiCpsObserver;

class CAknNoteDialog;

class CBrowserDialogsProvider;

class CBrCtlInterface;

class CLiwServiceHandler;

class MLiwInterface;

class CInternetConnectionManager;

class CSchemeHandler;

#ifdef BRDO_WRT_HS_FF

class CCpsPublisher;

#endif

// CLASS DECLARATION

/**

*  CWidgetUiWindowManager

*  @lib WidgetUi.app

*  @since 3.1

*/

class CWidgetUiWindowManager : public CBase

    {

    public:  // constructors / destructor

        /**

        * NewL

        * Two-phased constructor.

        * @since 3.1

        * @param none

        * @return CWidgetUiWindowManager*

        */

        static CWidgetUiWindowManager* NewL( CWidgetUiAppUi& aAppUi );

        /**

        * ~CWidgetUiWindowManger

        * Destructor

        * @since 3.1

        * @param none

        * @return none

        */

        virtual ~CWidgetUiWindowManager();

    public:  

// Create window

        /**

        * HandleWidgetCommandL

        * @since 5.0

        * @param aUid UID of widget.

        * @param aOperation Whether to open or close the widget, and how.

        */

        void HandleWidgetCommandL( 

            const TUid& aUid,

            TUint32 aOperation );

        /**

        * Resume a suspended widget.

        * @since 5.0

        * @param aUid UID of widget.

        */

        void ResumeWidgetL( const TUid& aUid );

        /**

        * CloseWindowsAsync

        * Close window async

        * @param aAllWindows ETrue closes all windows; EFalse closes active window

        * @since 3.1

        */

        void CloseWindowsAsync( TBool aAllWindows );

        /**

        * CloseAllWindowsExceptCurrent

        * Closes all of the window except the current widget

        * @since 3.1

        * @return none

        */            

        void CloseAllWindowsExceptCurrent();

        /**

        * CheckIfWindowNeedsToBeClosed

        * Returns false only for current window

        * @since 5.0

        * @return true if widget needs to be closed

        */ 

        TBool CheckIfWindowNeedsToBeClosed(CWidgetUiWindow* aWindow) const;

        /**

        * Exit the widget, if the widget is the only widget running, exit the application

        * otherwise, close the widget window and activate the next widget window who is running

        * @since 3.1

        */

        void Exit( TInt aCommand , const TUid& aUid);

        /**

        * SetActiveWidgetAtExit

        * Sets the FullView window which is not publishing to active

        * @since 5.0

        */ 

        void SetActiveWidgetAtExit();

// Query/set states.

        /**

        * SetDisplayLandscape

        * Called to change the display orientation to landscape

        * @since 3.1

        */

        void SetDisplayLandscape( );

        /**

        * GetWidgetEntryForUrl

        * Returns the UId of widget entry with a particular Url

        * @since 3.1

        * @param none

        * @return UId

        */

        TInt GetWidgetEntryForUrl( const TDesC& aUrl ); //const;

        /**

        * ActiveWindow

        * @since 3.1

        * @param none

        * @return CWidgetUiWindow*

        */

        inline CWidgetUiWindow* ActiveWindow() const { return iActiveFsWindow; }

        /**

        * GetWindow

        * Gets the window for certain widget identified by a URL

        * @since 3.1

        * @param aUrl - a URL to identify the widget

        * @return the widget running, null if not found

        */

        CWidgetUiWindow* GetWindow( const TDesC& aUrl );

        /**

        * GetWindow

        * Gets the window for certain widget identified by a Uid

        * @since 3.1

        * @param aUid - Uid to identify the widget

        * @return the widget running, null if not found

        */

        CWidgetUiWindow* GetWindow( const TUid& aUid );

        /**

        * SetView

        * @since 3.1

        * @param aContentView

        * @return void

        */

        void SetView( CWidgetUiWindowView& aContentView ) { iContentView = &aContentView; }

        /**

        * View

        * @since 3.1

        * @param none

        * @return CWidgetUiWindowView*

        */

        CWidgetUiWindowView* View() const { return iContentView; }

        /**

        * SetDisplayPortrait

        * Called to change the display orientation to portrait

        * @since 3.1

        */

        void SetDisplayPortrait( );

        /**

        * SetDisplayAuto

        * Called to change the display orientation to device defined

        * @since 3.1

        */

        void SetDisplayAuto( );

        /**

        * HandleForegroundEvent

        * Called when application goes to background or comes back to foreground

        * @since 3.1

        */

        void HandleForegroundEvent( TBool aForeground );

        /**

        * HandleOOMEventL

        * Called when out of memory message is received by app ui

        * @since 3.1

        */

        void HandleOOMEventL( TBool aForeground );

// Utility stuff.

        /**

        * WindowList

        * Gets the list of running windows

        * @since 3.1

        * @param none

        * @return CArrayPtrFlat<CWidgetUiWindow>*

        */

        void WindowList( RPointerArray<CWidgetUiWindow>& )  { /*return iWindowList; */ User::Invariant(); }

        /**

        * WidgetUIClientSession

        * @since 3.1

        * @param none

        * @return RWidgetUIRegistryClientSession*

        */

        RWidgetRegistryClientSession& WidgetUIClientSession() { return iClientSession; }

        /**

        * DialogsProvider

        * @since 3.1

        * @param none

        * @return CBrowserDialogsProvider

        */

        CBrowserDialogsProvider* DialogsProvider() { return iDialogsProvider; }

        /**

         * HandleLSKCommandL

         * @since 5.0

         * @param TInt - command to execute

         * @return TBool - True if LSK handler is executed

         */

        TBool HandleLSKCommandL( TInt aCommand );

        /**

        * DocHandler

        * @since 5.0

        * @return Document Handler.

        */

        inline CDocumentHandler& DocHandler() { return *iHandler; }

        /**

        * GetConnection

        * @since 5.0

        * @return CInternetConnectionManager

        */

        CInternetConnectionManager* GetConnection() {return iConnection;}

        /**

        * GetDb

        * @since 5.0

        * @return CActiveApDb

        */

        CActiveApDb*  GetDb() {return iDb;}

    protected:

        /**

        * CWidgetUiWindowManager

        * Constructor

        * @since 3.1

        * @param none

        * @return none

        */

        CWidgetUiWindowManager( CWidgetUiAppUi& aAppUi );

        /**

        * ConstructL

        * EPOC default constructor

        * @since 3.1

        * @param none

        * @return void

        */

        void ConstructL();

    private:

        /**

        * Hide the window.

        * @param aWindow Window. Ownership is retained.

        */

        void HideWindow( CWidgetUiWindow* aWindow );

        /** 

        * Is the widget allowed to run or not

        *

        * @param aUid out-param, contains the UID of widget aon return.

        */

        TBool IsWidgetAllowedL( const TUid& aUid );// const;

        /**

        * Notify user if widget is not allowed to run.

        *

        * @param aResourceID String identifier.

        */        

        void ShowNoteDialogL( TInt aResourceID ) const;

        /**

        * Create new window for a widget and add it to window list.

        *

        * @param aUid UID

        * @return Newly created window.

        */

        CWidgetUiWindow* CreateNewWidgetWindowL( const TUid& aUid );

        /**

        * Check if widget is supposed to support miniviews.

        *

        * @param aUid UID.

        * @return Whether widgets are supported or not.

        */

        TBool DoesWidgetSupportMiniviewL( const TUid& aUid );