/*

* Copyright (c) 2006 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:  Helper class for handling change notifications of 

*                PubSub properties and CenRep keys.

*

*/

#ifndef BTENGSETTINGSNOTIFY_H

#define BTENGSETTINGSNOTIFY_H

#include "btengactive.h"

#include "btengclient.h"

class MBTEngSettingsObserver;

class CRepository;

/**

 *  Class CBTEngSettingsNotify

 *

 *  ?more_complete_description

 *

 *  @lib btengsettings.lib

 *  @since S60 v3.2

 */

NONSHARABLE_CLASS( CBTEngSettingsNotify ) : public CBase, 

                                            public MBTEngActiveObserver

    {

public:

    /**

     * Two-phase constructor

     *

     * @since S60 v3.2

     * @param aObserver Pointer to callback interface that receives notification

     *                  that a setting has changed.

     * @return Pointer to the constructed CBTEngSettingsNotify object.

     */

    static CBTEngSettingsNotify* NewL( MBTEngSettingsObserver* aObserver );

    /**

     * Destructor

     */

    virtual ~CBTEngSettingsNotify();

    /**

     * Toggles the Bluetooth power state (on or off). Power will be switched on 

     * for the duriation of the session. It will also be turned off (gracefully, 

     * if no permanent connection exists) if this object is destroyed.

     * Note: power will only be switched off gracefully if it has also been 

     * switched on through this method, otherwise KErrAccessDenied will be 

     * returned.

     *

     * @since S60 v5.0

     * @return KErrNone on success, otherwise a system wide error code.

     */

    TInt TogglePowerTemporarily();

// from base class MBTEngActiveObserver

    /**

     * From MBTEngActiveObserver.

     * Handle a setting change.

     *

     * @since S60 v3.2

     * @param ?arg1 ?description

     */

    virtual void RequestCompletedL( CBTEngActive* aActive, TInt aId, 

                                     TInt aStatus );

    /**

     * From MBTEngActiveObserver.

     * Handle an error in the setting change handling.

     *

     * @since S60 v3.2

     * @param ?arg1 ?description

     */

    virtual void HandleError( CBTEngActive* aActive, TInt aId, TInt aError );

private:

    /**

     * C++ default constructor

     *

     * @since S60 v3.2

     * @param aObserver Pointer to callback interface that receives notification

     *                  that a setting has changed.

     */

    CBTEngSettingsNotify( MBTEngSettingsObserver* aObserver );

    /**

     * Symbian 2nd-phase constructor

     *

     * @since S60 v3.2

     */

    void ConstructL();

private: // data

    /**

     * Active object for watching power mode setting changes.

     * Own.

     */

    CBTEngActive* iPowerKeyWatcher;

    /**

     * Active object for watching visibility mode setting changes.

     * Own.

     */

    CBTEngActive* iVisiKeyWatcher;

    /**

     * Session with the central repository for power mode setting.

     * Own.

     */

    CRepository* iPowerKeyCenRep;

    /**

     * Session with the central repository for visibility mode setting.

     * Own.

     */

    CRepository* iVisiKeyCenRep;

    /**

     * Client to notify of changes.

     * Not own.

     */

    MBTEngSettingsObserver* iObserver;

    /**

     * Handle to BTEng server for turning Bluetooth on temporarily.

     */

    RBTEng iBTeng;

    };

#endif // BTENGSETTINGSNOTIFY_H