diff -r 000000000000 -r 72b543305e3a messagingappbase/ncnlist/inc/NcnSubscriber.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/messagingappbase/ncnlist/inc/NcnSubscriber.h Thu Dec 17 08:44:11 2009 +0200 @@ -0,0 +1,115 @@ +/* +* Copyright (c) 2004 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: Defines class CNcnSubscriber. +* +*/ + + + +#ifndef NCNSUBSCRIBER_H +#define NCNSUBSCRIBER_H + +// INCLUDES +#include +#include +#include "NcnPublishAndSubscribeObserver.h" + +// forward declarations +class MNcnSubscribeHandler; + +// CLASS DECLARATION +/** +* CNcnSubscriber is an acitve object that subscribes to a single +* Publish and Subscribe Property and notifies about the Property changes. +*/ + +class CNcnSubscriber : public CActive +{ +public: + /** + * Two-phased constructor. + * + * @param aPropertyResponder The object to be notified about Property changes + * @param aCategory The category of the Property to be observed + * @param aKey The subkey of the Property to be observed + */ + static CNcnSubscriber* NewL( MNcnSubscribeHandler& aPropertyResponder, const TUid& aCategory, TUint aKey ); + + /** + * Destructor. + */ + ~CNcnSubscriber(); + + /** + * Subscribes to the Property given in constructor + */ + void Subscribe(); + +private: + /** + * C++ default constructor. + * + * @param aPropertyResponder The object to be notified about Property changes + * @param aCategory The category of the Property to be observed + * @param aKey The subkey of the Property to be observed + */ + CNcnSubscriber( MNcnSubscribeHandler& aPropertyResponder, const TUid& aCategory, TUint aKey ); + + /** + * By default Symbian 2nd phase constructor is private. + */ + void ConstructL(); + +public: // from CActive + /** + * RunL + */ + void RunL(); + + /** + * RunError + * @param aError the error returned + * + * @return error + */ + TInt RunError( TInt aError ); + + /** + * DoCancel + */ + void DoCancel(); + +private: // Methods not implemented + CNcnSubscriber( const CNcnSubscriber& ); // Copy constructor + CNcnSubscriber& operator=( const CNcnSubscriber& );// Assigment operator + +private: // data + + // The object to be notified about Property changes + MNcnSubscribeHandler& iPropertyResponder; + + // The property object that subscribes to the Property to be observed + RProperty iProperty; + + // The category of the Property to be observed + TUid iCategory; + + // The subkey of the Property to be observed + TUint iKey; +}; + + +#endif // NCNSUBSCRIBER_H + +// End of File