/*

* Copyright (c) 2009 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:  Touch gesture framework central repository listener.

*

*/

#ifndef C_AKNTOUCHGESTUREFWCENREPLISTENER_H

#define C_AKNTOUCHGESTUREFWCENREPLISTENER_H

#include <e32base.h>

class CRepository;

namespace AknTouchGestureFw {

/**

*  The central repository observer interface.

*

*  Interface for a central repository observer.

*

*  @lib akntouchgesturefw

*  @since S60 v5.2

*/

class MAknTouchGestureFwCenRepObserver

    {

public:

    /**

     * Informs the observer that the central repository

     * value has been changed.

     *

     * @param  aKey  CenRep value key.

     */

    virtual void CenRepValueChanged( const TInt& aKey ) = 0;

    };

/**

 * Touch gesture framework central repository listener.

 */

NONSHARABLE_CLASS( CAknTouchGestureFwCenRepListener ) : public CActive

    {

public:

    /**

     * Two-phased constructor.

     *

     * @param  aCenRep    Repository to listen.

     * @param  aObserver  Repository observer.

     */

    static CAknTouchGestureFwCenRepListener* NewL(

            CRepository* aCenRep,

            MAknTouchGestureFwCenRepObserver* aObserver );

    /**

     * Two-phased constructor.

     *

     * @param  aCenRep    Repository to listen.

     * @param  aObserver  Repository observer.

     */

    static CAknTouchGestureFwCenRepListener* NewLC(

            CRepository* aCenRep,

            MAknTouchGestureFwCenRepObserver* aObserver );

    /**

     * Destructor.

     */

    virtual ~CAknTouchGestureFwCenRepListener();

public: // From base class CActive.

    /**

     * Handles an active object's request completion event.

     */

    void RunL();

    /**

     * Implements cancellation of an outstanding request.

     */

    void DoCancel();

    /**

     * Handles errors during the request completion

     *

     * @param  aError  Error code of the leave.

     *

     * @return KErrNone

     */

    TInt RunError( TInt aError );

private:

    /**

     * C++ constructor.

     *

     * @param  aCenRep    Repository to listen.

     * @param  aObserver  Repository observer.

     */

    CAknTouchGestureFwCenRepListener(

            CRepository* aCenRep,

            MAknTouchGestureFwCenRepObserver* aObserver );

    /**

     * Symbian second-phase constructor.

     */

    void ConstructL();

    /**

     * Renews the request.

     */

    void RenewRequestL();

private: // data

    /**

     * Central repository.

     * Not own.

     */

    CRepository* iCenRep;

    /**

     * CenRep observer.

     * Not own.

     */

    MAknTouchGestureFwCenRepObserver* iObserver;

    };

} // AknTouchGestureFw

#endif // C_AKNTOUCHGESTUREFWCENREPLISTENER_H