/*

* Copyright (c) 2002 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:  Call diverting class. Sets and gets call diverting status. 

*

*

*/

#ifndef     PSETCALLDIVERTING_H

#define     PSETCALLDIVERTING_H

//  INCLUDES           

#include <mmretrieve.h>

#include "nwdefs.h"             

//  FORWARD DECLARATIONS

class CDesC16ArrayFlat;

class MPsetDivertObserver;

class MPsetRequestObserver;

class RVmbxNumber;

class CRepository;

class TCallDivertNotifySetting;

class MPSetCallDiverting;

class CPSetCallDivertingFactory;

class MCallDiverting;

enum TSelectedLine

    {

    };

//  CLASS DECLARATION  

/**

*  CPsetCallDiverting class is call diverting SS handler. 

*  @lib phonesettings.lib

*  @since 1.0

*/

class   CPsetCallDiverting : public CBase,

                             public MPsetCallDiverting

    {

    public: // constructor & destructor

        /**

        * Symbian OS 2-phase Constructor.

        *

        * @param aObserver Call divert observer.

        * @param aPhone Provides client access to 

        *               mobile phone functionality provided by TSY.

        * @return Created CPsetCallDiverting object.

        */

        IMPORT_C static CPsetCallDiverting* NewL( 

            MPsetDivertObserver& aObserver, 

            RMobilePhone& aPhone);

        /* 

        * Destructor.

        */

        IMPORT_C ~CPsetCallDiverting();

    public: // From base class.

        /**

        * @see MPsetCallDiverting::SetDivertingL().

        */

        IMPORT_C void SetDivertingL( const TCallDivertSetting& aDivert, 

            TBasicServiceGroups aBsc, TBool aVmbx = EFalse ); 

        /**

        * @see MPsetCallDiverting::GetDivertingStatusL().

        */ 

        IMPORT_C void GetDivertingStatusL( const TServiceGroup aServiceGroup, 

            const TCallDivertingCondition aCondition, 

            TBasicServiceGroups aBsc );

        /**

        * @see MPsetCallDiverting::CancelCurrentRequest().

        */ 

        IMPORT_C TInt CancelCurrentRequest(); 

    public: //new

        /**

        *  Gets the default time for CF No Reply.

        *  No error checking for return values which should be

        *  5-30, in steps of 5.

        *

        * @return Returns the current timer value.

        */

        IMPORT_C TInt GetTimerValueL();    

        /**

        *  Sets the default time for CF No Reply.

        *  No error checking to parameters, which should be on range 5-30,

        *  using steps of 5.

        *

        *  @param aIndex New value for timer.

        *  @return Returns error code.

        */

        IMPORT_C TInt SetTimerValueL( const TInt& aIndex );    

        /**

        * The default (last forwarded-to) numbers can be retrieved 

        * through this method. 

        *

        * @param aDefNumbers Read default numbers from shared data.

        * @return Returns error code or amount of numbers read.

        */

        IMPORT_C TInt GetDefaultNumbersL( CDesC16ArrayFlat& aDefNumbers );            

        /**

        * Sets new default number to the default numbers list, 

        * erases the oldest one automatically, if three numbers already in the

        * shared data.

        *

        * @param aNumber New number to be added.

        * @return Returns error code.

        */

        IMPORT_C TInt SetNewDefaultNumberL( TDes& aNumber );    

        /**

        * Swaps the most recently used number to first in shared data file.

        *

        * @param  aLocation Used number's location (1-3) in shared data.

        */

        IMPORT_C void SwapDefaultNumberL( const TInt& aLocation );

        /**

        * Saves last used data number to shared data.

        *

        * @param  aNumber Number used for data call forwarding.

        * @return Returns error code.

        */

        IMPORT_C TInt SetUsedDataNumberL( TTelNumber& aNumber );

        /**

        * Saves last used fax number to shared data.

        *

        * @param  aNumber Number used for data fax forwarding.

        * @return Returns error code.

        */

        IMPORT_C TInt SetUsedFaxNumberL( TTelNumber& aNumber );

        /**

        * Gets the phone number used for fax call forwarding.

        *

        * @return Number used for data call forwarding.

        */

        IMPORT_C HBufC* GetUsedFaxNumberLC();

        /**

        * Gets the phone number used for data call forwarding.

        *

        * @return Number used for data call forwarding.

        */

        IMPORT_C HBufC* GetUsedDataNumberLC();

        /** 

        * Sets request observer.

        *

        * @param aObs Where the request completion should be informed to.

        */        

        IMPORT_C void SetRequestObserver( MPsetRequestObserver* aObs );

        /** 

        * Queries for voice mail box number. If number is undefined, number 

        * entry pops up.

        * @since 2.0

        * 

        * @param aTelNumber Vmbx number.

        */        

        IMPORT_C void VoiceMailQueryL( TDes& aTelNumber );

        /** 

        * Queries for video mailbox number. If number is undefined, number 

        * entry pops up.

        * @since 3.1

        * 

        * @param aTelNumber Video mailbox number.

        */         

        IMPORT_C void VideoMailQueryL( TDes& aTelNumber );

    private: //new

        TInt OpenVideoMailboxLC( TDes& aTelNumber, RVmbxNumber& aVmbx );

    private: // constructors

        void ConstructL( MPsetDivertObserver& aObserver );

        CPsetCallDiverting( RMobilePhone& aPhone );

    private: //member data

        // Observer for Call divert requests

        MPsetDivertObserver* iObserver;

        // Provides client access to mobile phone functionality provided by TSY.

        RMobilePhone& iPhone;

        // Request observer

        MPsetRequestObserver* iReqObserver;

        // Central repository.

        CRepository* iRepository;

        // Call Divert implementation.

        MCallDiverting* iDivert;

     };

#endif      //  PSETCALLDIVERTING_H

// End of File