/*

* 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:  CMSPropertyWatcher class defition

*

*/

#ifndef __MSPROPERTYWATCHER_H__

#define __MSPROPERTYWATCHER_H__

// Include Files

#include <e32base.h>

#include <e32property.h>

#include "cmcommon.h"

// FORWARD DECLARATIONS

class MMSPropertyObserver;

// CLASS DECLARATION

/**

 * Active object class for MSEngine

 * @since S60 5.1

 */

NONSHARABLE_CLASS( CMSPropertyWatcher ): public CActive

    {

    public:

        /**

         * Two-phased constructor.

         */

        static CMSPropertyWatcher* NewL();

        /**

         * Two-phased constructor.

         */

        static CMSPropertyWatcher* NewLC();        

        /**

        * Destructor.

        */

        virtual ~CMSPropertyWatcher();

        /**

         * Sets property observer

         * @since S60 5.1

         * @param aObserver, property observer

         * @return None

         */

        void SetObserver( MMSPropertyObserver* aObserver );

        /**

         * Starts listening property

         * @since S60 5.1

         * @param None

         * @return None

         */

        void StartL();

        /**

         * Stops listening property

         * @since S60 5.1

         * @param None

         * @return None

         */

        void Stop();

    protected:

// From base class CActive

        /**

         * From CActive

         * See base class definition

         */

        virtual void RunL();

        /**

         * From CActive

         * See base class definition

         */

        virtual void DoCancel();

        /**

         * From CActive

         * See base class definition

         */

        TInt RunError( TInt aError );  

    private:

        /**

         * Performs the first phase of two phase construction.

         */

        CMSPropertyWatcher();

        /**

         * Performs the second phase construction.

         */

        void ConstructL();

    private:

        /**

         * property

         */

        RProperty                       iProgressInfo;

        /**

         * property observer

         */

        MMSPropertyObserver*            iObserver;      // not owned

    };

/**

 *  Property observer

 *  @since Series 60 3.1

 */

class MMSPropertyObserver

    {

    public:

    /**

     * Informs about property changes

     * @param aService, completed service

     * @param aError, error code

     * @since S60 5.1

     */

     virtual void PropertyChangedL( TCmService aService,

                                    TInt aTotalItems,

                                    TInt aProcessedItems,

                                    TInt aItemsToBeProcessed ) = 0;

    };

#endif  // __MSPROPERTYWATCHER_H__

// End of file