/*
* Copyright (c) 2007-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:  Class header for CWsfActiveTimeUpdater
*
*/

#ifndef C_WSFACTIVETIMEUPDATER_H
#define C_WSFACTIVETIMEUPDATER_H

//  EXTERNAL INCLUDES
#include <e32base.h>

//  INTERNAL INCLUDES

//  FORWARD DECLARATIONS
class MWsfActiveTimerHandler;


/**
 *  Responsible for time updating by using a customizable time interval.
 *  @since S60 v5.0
 */
NONSHARABLE_CLASS( CWsfActiveTimeUpdater ) : public CBase
    {
    public:     // Constructors and destructor
        
        /**
         * Two-phased constructor
         * @since S60 5.0 
         * @param aActiveTimerHandler interface details views controller
         * @return instance of CWsfActiveTimeUpdater class
         */
        static CWsfActiveTimeUpdater* NewL(
                MWsfActiveTimerHandler* aActiveTimerHandler );


        /**
         * Two-phased constructor. Leaves the object on CleanupStack
         * @since S60 5.0 
         * @param aActiveTimerHandler interface details views controller
         * @return instance of CWsfActiveTimeUpdater class
         */
        static CWsfActiveTimeUpdater* NewLC( 
                MWsfActiveTimerHandler* aActiveTimerHandler );
        
        /**
         * Destructor of CWsfActiveTimeUpdater class
         * @since S60 5.0     
         */
        ~CWsfActiveTimeUpdater();
        
    private:    // Constructors
        
        /**
         * Default C++ constructor 
         * @since S60 5.0 
         * @param aActiveTimerHandler interface details views controller
         */
        CWsfActiveTimeUpdater( MWsfActiveTimerHandler* aActiveTimerHandler );
        
        /**
         * 2nd phase constructor
         * @since S60 5.0 
         */
        void ConstructL();
    
    public:     // New methods
    
        /**
         * Start update timer
         * @since S60 5.0 
         * @param aUpdateInterval refresh time interval
         */
        void Start( TInt aUpdateInterval );
        
        /**
         * Stop update timer
         * @since S60 5.0 
         */
        void Stop();
    
        /**
         * Called from static call back of CPeriodic.
         * The actual update process starts here
         * @since S60 5.0 
         */
        void DoUpdateTimeL();
        
    private:    // New methods
        /**
         * Function to called when periodic timer releases
         * @since S60 5.0 
         * @param aUpdater pointer to this
         */
        static TInt UpdateTimeL( TAny* aUpdater );
    
    private: 
    
        /**
         * Pointer to the Active Timer handler interface 
         * Own.
         */
        MWsfActiveTimerHandler* iActiveTimerHandler;

        /**
         * Timer, to refresh the details views
         * Own.
         */
        CPeriodic* iPeriodic;
    };

#endif // C_WSFACTIVETIMEUPDATER_H