idlehomescreen/hscontentcontrol/inc/hscontentcontrolfactory.h
branchRCL_3
changeset 83 5456b4e8b3a8
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/idlehomescreen/hscontentcontrol/inc/hscontentcontrolfactory.h	Wed Sep 01 12:32:46 2010 +0100
@@ -0,0 +1,161 @@
+/*
+* Copyright (c) 2008 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 HSCONTENTCONTROLFACTORY_H
+#define HSCONTENTCONTROLFACTORY_H
+
+// System includes
+#include <e32base.h>
+#include <hscontentcontrolui.h>
+
+// User includes
+#include "hscontentcontrolecomobserver.h"
+#include "hscontentcontrolswiobserver.h"
+
+// Forward declarations
+class CHsContentControlEComListener;
+class CHsContentControlSwiListener;
+class CXnAppUiAdapter;
+
+/**
+ *  Content control UI base class
+ *
+ *
+ *  @code
+ *
+ *  @endcode
+ *
+ *  @lib hscontentcontrol.lib
+ *  @since S60 v5.0
+ */
+NONSHARABLE_CLASS( CHsContentControlFactory ) : public CBase,
+                                                public MHsContentControlEComObserver,
+                                                public MHsContentControlSwiObserver
+    {
+public: // Constructor and destructor
+    /**
+     * Two-phased constructor.
+     */
+    IMPORT_C static CHsContentControlFactory* NewL( CXnAppUiAdapter& aAdapter );
+
+    /**
+     * Destructor.
+     */
+    IMPORT_C ~CHsContentControlFactory();
+
+private: // from MHsContentControlEComObserver
+    
+    /**
+     * Notification of Ecom registry change.
+     */
+     void HandleEComChangeEvent();
+
+private: // from MHsContentControlSwiObserver
+    
+    /**
+     * Notification of Install/Uninstall event from SWI.
+     * @param aUidList The package UID list which is being processed.
+     */
+     void HandleSwiEvent( const RArray<TUid>& aUidList );
+    
+private: // Constructors
+    /**
+     * Constructor
+     */
+    CHsContentControlFactory( CXnAppUiAdapter& aAdapter );
+
+    /** Second phase constructor */
+    void ConstructL();
+
+public: // New functions
+    /**
+     * 
+     */
+    IMPORT_C MHsContentControlUi* GetHsContentController(
+        const TDesC8& aControllerType );
+
+    /**
+     * 
+     */
+    IMPORT_C void PrepareToExit();
+
+private:
+
+    /** 
+     * Deregisters/Removes/Deletes plugin's views from AppUi.
+     */
+    void ReleaseHsCcUi( CHsContentControlUi* aHsContentControlUi );
+
+    /** 
+     * Finds and returns loaded ContentControlUi object from array.
+     */
+    MHsContentControlUi* FindHsContentController(
+        const TDesC8& aControllerType );
+    
+    /** 
+     * Checks if a plugin is removed/upgraded/downgraded.
+     */
+    void CheckPluginChangesL();
+    
+    /**
+     * Finds plugin implementation info in the ECOM registry.
+     * @param aUid The plugin UID which is to be checked.
+     * @param aPluginArray The array of plugins which have been implemented.
+     * @return ImplementationInfo of plugin.
+     */
+    CImplementationInformation* FindPluginImplInfo( 
+            const TUid& aUid, const RImplInfoPtrArray& aPlugInArray );
+
+    /**
+     * Checks if an upgrade or downgrade of the existing plugins happened.
+     * @param aPluginImplInfo ImplInfo of plugin to be checked for upgrade/downgrade.
+     * @return ETrue if upgrade/downgrade, EFalse otherwise. 
+     */
+    TBool PluginUpgradeDowngrade( const CImplementationInformation& aPluginImplInfo );
+
+private: // Data
+
+    /**
+     * Reference to XnAppUiAdapter.
+     */
+    CXnAppUiAdapter& iAdapter;
+
+    /**
+     * An array of type CHsContentControlUi ( Owned ).
+     */
+    RPointerArray< CHsContentControlUi > iHsContentControlUis;
+    
+    /**
+    * An array of type CImplementationInformation ( Owned ).
+    */
+    RImplInfoPtrArray               iImplArray;
+
+    /**
+     * An object of type CHsContentControlEComListener ( Owned ).
+     */
+    CHsContentControlEComListener*  iHsContentControlEComListener;
+
+    /**
+     * An object of type CHsContentControlSwiListener ( Owned ).
+     */
+    CHsContentControlSwiListener*  iHsContentControlSwiListener;
+    };
+
+
+#endif // HSCONTENTCONTROLFACTORY_H
+
+// End of file