diff -r 000000000000 -r f72a12da539e menufw/menufwui/mmextensions/mmextensionmanager/inc/mmecomobserver.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/menufw/menufwui/mmextensions/mmextensionmanager/inc/mmecomobserver.h Thu Dec 17 08:40:49 2009 +0200 @@ -0,0 +1,131 @@ +/* +* 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: Menu Framewrok ECom observer +* +*/ + +#ifndef C_ECOM_OBSERVER_H +#define C_ECOM_OBSERVER_H + +#include // For CActive, link against: euser.lib +#include // For RTimer, link against: euser.lib + +class REComSession; + +/** + * Class defining callback interface. + */ + +/** + * MHNEcomInstallNotifierCallback is an interface contains function + * executed when ECom plugin have changed. Interface is used by all + * ECom observer implementations. + * + * @since S60 5.0 + * @ingroup group_mmextensions + */ +class MHNEcomInstallNotifierCallback + { +public: + + /** + * Refreshes list of MultimediaMenu plugins implementations. + */ + virtual void EcomChangedL() = 0; + }; + +/** + * Class for observing ECom server + */ + +/** + * CMMEcomObserver is a class represents ECom plugin. Class is + * derived by all ECom plugin implemetations. Implementation + * contains basic functionality related with ECom mechanism and + * notification handling. + * + * @since S60 5.0 + * @ingroup group_mmextensions + */ +NONSHARABLE_CLASS( CMMEcomObserver ) : public CActive + { +public: + /** + * Cancel and destroy. + */ + ~CMMEcomObserver(); + + /** + * Two-phased constructor. + * @param aCallback Pointer to ECom plugin callback. + * @return Instance of the CMMEcomObserver class. + */ + static CMMEcomObserver* NewL( MHNEcomInstallNotifierCallback* aCallback ); + + /** + * Two-phased constructor. + * @param aCallback Pointer to ECom plugin callback. + * @return Instance of the CMMEcomObserver class. + */ + static CMMEcomObserver* NewLC( MHNEcomInstallNotifierCallback* aCallback ); + +private: + /** + * Default C++ constructor. + */ + CMMEcomObserver(); + + /** + * Second-phase constructor. + * @param aCallback Pointer to ECom plugin callback. + */ + void ConstructL( MHNEcomInstallNotifierCallback* aCallback ); + +private: + + /** + * From CActive. Handles completion. + */ + void RunL(); + + /** + * Cancels active object. + */ + void DoCancel(); + + /** + * Override to handle leaves from RunL(). Default implementation causes + * the active scheduler to panic. + * @param aError Currently error status. + * @return Error code. + */ + TInt RunError( TInt aError ); + +private: + + /** + * ECom handler + * Own. + */ + REComSession* iSession; + + /** + * Callback pointer. + * Not own. + */ + MHNEcomInstallNotifierCallback* iCallback; + + }; + +#endif // C_ECOM_OBSERVER_H