/*

* Copyright (c) 2003 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:  This file contains the header file of the server-side settings 

*                subsession class.

*

*/

#ifndef     CCBSSETTINGS_H

#define     CCBSSETTINGS_H

// INCLUDES

#include "CCbsSession.h"

#include "CCbsObject.h"

#include "MCbsDbSettingsObserver.H"

// FORWARD DECLARATIONS

class CCbsDbImpSettings;

class CCbsRecEtel;

//  CLASS DECLARATION 

/**

*   The server-side CbsClient subsession for modifying settings.

*/

class   CCbsSettings

        : public CCbsObject, public MCbsDbSettingsObserver

    {

    public:     // New functions

        /**

        *   Creates a new instance of the class.

        *

        *   @param  aSession        Session object

        *   @param  aSettings       Database settings manager

        *   @param  aReceiver       Receiver object

        *   @return                 Pointer to a new instance of CCbsSettings

        */

        static CCbsSettings* NewL( CCbsSession& aSession, 

                                   CCbsDbImpSettings& aSettings, 

                                   CCbsRecEtel& aReceiver );

        /**

        *   Destructor.

        */

        ~CCbsSettings();

    public:     // From CCbsObject

        /**

        *   Handle the requests for the object.

        *

        *   @param  aMessage        Message to be handled.

        *   @return                 Indicates whether the message was handled.

        */

        TBool HandleRequestsL( const RMessage2& aMessage );

    private:        // From MCbsDbSettingsObserver

        /**

        *   Called when the topic detection is changed.

        */

        void TopicDetectionStatusChangedIndL();

        /**

        *   Called when reception status is changed.

        */

        void ReceptionStatusChangedIndL();

        /**

        *   Called when preferred languages are changed.

        */

        void LanguagesChangedIndL();

        /**

        *   Called when time-limited reception status changed

        */

        void LimitedReceptionStatusChangedIndL();

        /**

        *   Called when clean up interval of read messages changed

        */

        void CleanupTimeChangedIndL();

    private:

        /**

        *   Constructor.

        *

        *   @param  aSession        Session session object

        *   @param  aSettings       Database settings manager

        *   @param  aReceiver       Receiver

        */

        CCbsSettings( CCbsSession& aSession, 

                      CCbsDbImpSettings& aSettings, 

                      CCbsRecEtel& aReceiver );

        /**

        *   Finalizes construction.

        */

        void ConstructL();

        /**

        *   Close the subsession.

        *

        *   Note that the method will delete itself, so the object is no

        *   longer valid after the call.

        */

        void CloseSettings();

        /**

        *   Return the current reception status to the client.

        */

        void GetReceptionStatusL();

        /**

        *   Change the reception status to the requested one.

        */

        void SetReceptionStatusL();

        /**

        *   Return the current topic detection status to the client.

        */

        void GetTopicDetectionStatusL();

        /**

        *   Change the topic detection status to the requested one.

        */

        void SetTopicDetectionStatusL();

        /**

        *   Return the preferred languages to the client.

        */

        void GetLanguagesL();

        /**

        *   Change the preferred languages to the requested.

        */

        void SetLanguagesL();

        /**

        *   Make request to notify when settings are changed.

        */

        void NotifySettingsChanged();

        /**    

        *   Cancel the request to notify when settings are changed.

        */

        void NotifySettingsChangedCancel();

        /**

        *   Notifies the client (if there is a pending request).

        *   

        *   @param  aEvent          Identifies the type of request that 

        *                           has happened.

        */

        void NotifyClientL( TCbsSettingsEvent aEvent );

    private:    // Prohibited operators and functions

        // Copy constructor

        CCbsSettings( const CCbsSettings& );

        // Assignment operator

        CCbsSettings& operator=( const CCbsSettings& );

    private:    // Data

        // Reference to the database settings manager

        CCbsDbImpSettings& iSettings;

        // Reference to the receiver

        CCbsRecEtel& iReceiver;

        // Indicates whether iMessage is a valid message; that is, there

        // is a pending notify request.        

        TBool iIsMessage;

        // Message of the pending notify request, if available 

        RMessage2 iMessage;

    };

#endif      //  CCBSSETTINGS_H   

// End of File