/*

* Copyright (c) 2002-2004 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:  Supports registration of UI Lib modules.

*

*/

#ifndef CDOWNLOADMGRUILIBREGISTRY_H

#define CDOWNLOADMGRUILIBREGISTRY_H

//  INCLUDES

#include <e32std.H>

#include <e32base.h>

// FORWARD DECLARATIONS

class CDownloadMgrUiUserInteractions;

class CDownloadMgrUiDownloadsList;

class RHttpDownloadMgr;

class RHttpDownload;

class CUiLibRegistryExtension;

// CLASS DECLARATION

/**

*  This abstarct class represents an accessor for the resources of the UI Lib Registry.

*/

NONSHARABLE_CLASS( MDownloadMgrUiLibRegModel )

    {

    public:

        /**

        * Third UID of the Client App, which installed UI Lib.

        * This is the UID with which RHttpDownloadMgr was connected.

        */

        virtual TUid ClientAppUid() const = 0;

        /**

        * Is Downloads List installed?

        */

        virtual TBool DownloadsListInstalled() const = 0;

        /**

        * Reference to the Downloads List.

        */

        virtual CDownloadMgrUiDownloadsList& DownloadsList() const = 0;

        /**

        * Is User Interactions installed?

        */

        virtual TBool UserInteractionsInstalled() const = 0;

        /**

        * Reference to the User Interactions.

        */

        virtual CDownloadMgrUiUserInteractions& UserInteractions() const = 0;

        /**

        * Reference to the observed DMgr session.

        */

        virtual RHttpDownloadMgr& DownloadMgr() const = 0;

        /**

        * All download in Download Manager session.

        */

        virtual TInt DownloadCount() const = 0;

    };

/**

*  Supports registration of a User Interactions and a Downloads List component.

*/

NONSHARABLE_CLASS( CDownloadMgrUiLibRegistry ) : public CBase,

                                                 public MDownloadMgrUiLibRegModel

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        * @param aDownloadMgr The initial Download Manager session

        */

        IMPORT_C static CDownloadMgrUiLibRegistry* NewL( RHttpDownloadMgr& aDownloadMgr );

        /**

        * Destructor.

        */

        IMPORT_C virtual ~CDownloadMgrUiLibRegistry();

    public: // New functions

        // ******* Register User Interactions and Downloads List

        /**

        * Register a User Interactions.

        * The created component will be owned by the Registry.

        * @return Reference to the constructed object.

        */

        IMPORT_C CDownloadMgrUiUserInteractions& RegisterUserInteractionsL();

        /**

        * Register a Downloads List.

        * The created component will be owned by the Registry.

        * @return Reference to the constructed object.

        */

        IMPORT_C CDownloadMgrUiDownloadsList& RegisterDownloadsListL();

    public: // Functions from MDownloadMgrUiLibRegModel

        virtual TUid ClientAppUid() const;

        virtual TBool DownloadsListInstalled() const;

        virtual CDownloadMgrUiDownloadsList& DownloadsList() const;

        virtual TBool UserInteractionsInstalled() const;

        virtual CDownloadMgrUiUserInteractions& UserInteractions() const;

        virtual RHttpDownloadMgr& DownloadMgr() const;

        virtual TInt DownloadCount() const;

    private: // Constructors

        /**

        * C++ default constructor.

        */

        CDownloadMgrUiLibRegistry( RHttpDownloadMgr& aDownloadMgr );

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL();

    private: // New functions

        /**

        * Set registered UI components as observers of iDownloadMgr.

        */

        void SetUiComponentsAsObserversL();

        /**

        * Remove registered UI components as observers from iDownloadMgr.

        */

        void RemoveUiComponentsAsObservers();

    private: // Data

        CUiLibRegistryExtension* iExtension; ///< Extension class. Owned.

        // UI components

        CDownloadMgrUiUserInteractions* iUserInteractions; // Owned.

        CDownloadMgrUiDownloadsList*    iDownloadsList; // Owned.

        // Observed DM session

        RHttpDownloadMgr& iDownloadMgr; ///< Observed.

        TUid iClientAppUid;

    };

#endif /* CDOWNLOADMGRUILIBREGISTRY_H */