diff -r 000000000000 -r 5f000ab63145 phoneapp/phoneuiutils/inc/cphonecenrepeventhandler.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/phoneapp/phoneuiutils/inc/cphonecenrepeventhandler.h Mon Jan 18 20:18:27 2010 +0200 @@ -0,0 +1,110 @@ +/* +* Copyright (c) 2005 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: Central Repository event handler +* +*/ + + +#ifndef __CPHONECENREPEVENTHANDLER_H +#define __CPHONECENREPEVENTHANDLER_H + +// INCLUDES +#include +#include +#include + +// FORWARD DECLARATIONS + +// CLASS DECLARATION + +/** +* Class for observing central repository variable changes. +*/ + +class CPhoneCenRepEventHandler : + public CBase, + public MCenRepNotifyHandlerCallback + { + public: // Constructors and destructor + /** + * Default constructor + */ + static CPhoneCenRepEventHandler* NewL( const TUid& aUid ); + + /** + * Destructor. + */ + virtual ~CPhoneCenRepEventHandler(); + + private: + + /** + * EPOC default constructor. + * @return void + */ + void ConstructL(); + + /** + * Constructor + * @param aUid identifing the central repository UID. + * @return void + */ + CPhoneCenRepEventHandler( const TUid& aUid ); + + /** + * C++ default constructor. + * @param None + * @return void + */ + CPhoneCenRepEventHandler(); + + public: // From MCenRepNotifyHandlerCallback + + /** + * Notify the client about generic changes for the central repository + * key. + * @param aId Id of the key that has changed. + * @return none + */ + void HandleNotifyGeneric( TUint32 aId ); + + /** + * Notify the client about errors in the handler. Any error in + * handling causes the handler to stop handling any more notifications. + * Handling can be restarted with a call to aHandler->StartListeningL(), + * if the error is non-fatal. However, be careful to trap any errors + * from this call if this is done. + * @param aId Id of the key this instance listens for or if + * notifications for whole repository are listened, could also be + * KInvalidNotificationId. + * @param aError Error code. + * @param aHandler Pointer to the handler instance. This pointer can + * be used to identify the handler or restart the listening. + * @return none + */ + void HandleNotifyError( + TUint32 aId, + TInt error, + CCenRepNotifyHandler* aHandler ); + + private: // Data + + TUid iUid; + CRepository* iRepository; + CCenRepNotifyHandler* iCenRepNotifyHandler; + }; + +#endif // __CPHONECENREPEVENTHANDLER_H + +// End of File