/*

* Copyright (c) 2002-2004 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:   Active object wrapper for launching Settings UI

*

*/

#ifndef C_COMASUPLSETTINGSLAUNCHER_H

#define C_COMASUPLSETTINGSLAUNCHER_H

// INCLUDES

#include <e32std.h>

#include <agentdialog.h>    // for RGenConAgentDialogServer

const TUid KNotifier1Uid = { 0x10009C00 };

const TUid KNotifier2Uid = { 0x10009C01 };

const TUid KNotifier3Uid = { 0x10009C02 };

// FORWARD DECLARATIONS

class MOMASuplUISettingsObserver;

class CLocSettingsUiClient;

class COMASuplTrace;

/**

* Active object wrapper for launching Supl Settings UI.

* User of this class needs to implement relevant MOMASuplUISettingsObserver interface

* methods to receive notifications.

*/

class COMASuplSettingsLauncher : public CActive

    {

    public:

		enum TSuplDialogType

			{

				ESUPLYesNoDialog  = 0,

				ESUPLIAPDialog,

				ESUPLUsageDialog,

				ESUPLTimeoutDialog		

			};	

        /**

        * This is a two-phase constructor method that is used to

        * create a new instance for launching settings UI

        *

        * @param aCallback Reference to a callback instance.

        * @return          A pointer to a new instance of the COMASuplSettingsLauncher class.

        */

        static COMASuplSettingsLauncher* NewL(MOMASuplUISettingsObserver& aCallback);

        /**

        * This is a two-phase constructor method that is used to create a new

        * instance for launching settings UI

        * Leaves the constructed instance to cleanup stack.

        *

        * @param aCallback Reference to a callback instance.

        * @return          A pointer to a new instance of the COMASuplSettingsLauncher class.

        */

        static COMASuplSettingsLauncher* NewLC(MOMASuplUISettingsObserver& aCallback);

        /**

        * When this method is called, the COMASuplSettingsLauncher launches the

        * settings UI

        *

        * @throws error code depending on whether launch was successful or failed

        */

        TInt LaunchSettings();

        /**

        * When this method is called, the COMASuplSettingsLauncher cancels the 

        * launch if it has not been already launched

        */

        void CancelLaunch();

        /**

        * When this method is called, the COMASuplSettingsLauncher launches the

        * settings UI

        *

        * @throws error code depending on whether launch was successful or failed

        */

        TInt LaunchSuplUsageSettingsUI(TBool aRoaming);

        /* Launches the Dialog saying one or more location requests were cancelled

        */

        TInt LaunchSessionTimeOutDialog();

        /**

        * Destructor.

        */

        virtual ~COMASuplSettingsLauncher();

        TInt GetIAPName(TDes& aIAPName,TUint32& aIAPId);	

    protected:

        /**

        * Implements CActive

        * @param none

        * @return none

        */    

        void RunL();

        /**

        * Implements CActive

        * @param aError the error returned

        * @return error

        */

        TInt RunError(TInt aError);

        /**

        * Implements CActive

        * @param none

        * @return none

        */    

        void DoCancel();

    private:

        /**

        * Default Constructor

        * @param aCallback Reference to a callback instance.

        * @return None

        */

        COMASuplSettingsLauncher(MOMASuplUISettingsObserver& aCallback);

        void ConstructL();                                         

   private:

   		TInt LaunchIAPDialog();       

   		void ConvertIAPIdtoNameL( const TUint aIAPId,TDes& aIAPName );                            

    private:

        // not owned by this class

        MOMASuplUISettingsObserver& iCallback; 

        // Settings Launcher

        CLocSettingsUiClient* iSettingsLauncher;

		//Trace Utility

		COMASuplTrace* iTrace;

		TSuplDialogType  iDialogType;

        RNotifier iNotifier;

	    TBuf8<256>	buffer1;

	    TBuf8<256>  buffer2;

        TBool iRoaming;

		/**

		* Selected IAP ID

		*/

        TUint32                     	iSelectedIap;

    };

/**

* This class provides a callback interface for handling the

* completion of settings.  The Client derives a

* class from this interface and implements the SettingsUICompleted-methods

* that interest it.

*/

class MOMASuplUISettingsObserver

    {

    public:

    /** 

    * This callback method is used to notify the client about

    * completion of settingsUi Launch

    * @param aError error encountered while launching change

    * @return None

    */

    virtual void SettingsUICompletedL(TInt aError) = 0;

    /** 

    * This callback method is used to notify the client about

    * completion of settingsUi Launch for SUPL state

    * @param aError error encountered while launching change

    * @return None

    */

    virtual void SettingsUsageUICompletedL(TInt aError) = 0;

    /** 

    * This callback method is used to notify the client about

    * completion of Timeout UI

    * @param aError error encountered while launching change

    * @return None

    */

    virtual void SettingsTimeOutUICompletedL(TInt aError) = 0;

    };

#endif      // C_COMASUPLSETTINGSLAUNCHER_H

// End of File