/*
* 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:  Wizard used for adding connection methods
*
*/

#ifndef T_TCMWIZARD_H
#define T_TCMWIZARD_H

// INCLUDE FILES
#include <e32def.h>
#include <AknProgressDialog.h>

// FORWARD DECLARATIONS
class CAknWaitDialog;
class CCmDestinationImpl;
class CCmManagerImpl;
class CCmPluginBase;

/**
 *  Connection Method wizard
 *
 *  Wizard used for creating a new Connection Method.
 *
 *  @lib cmmanager.lib
 *  @since S60 v3.2
 */
NONSHARABLE_CLASS( CCmWizard ) : public CBase,
                                 public MProgressDialogCallback
    {
    public: // constructor

        /**
         * Constructor.
         *
         * @param aCmManager Connection Method Manager implementation passed
         * for queries.
         */
        CCmWizard( CCmManagerImpl& aCmManager );

        /**
        * Destructor.
        */
        ~CCmWizard();

    public: // public methods
    
        /**
        * Key method for creating a new Connection Method. This function
        * guides the user through several steps and then finally creates
        * a new Connection Method based on the information the user has given.
         * @param aTargetDestination Target destination to which the new
         * connection method will be added. Can be NULL if the
         * destination is to be selected by the user later on (via a dialog).
        */
        TInt CreateConnectionMethodL
                            ( CCmDestinationImpl* aTargetDestination = NULL );

    public: // from MProgressDialogCallback
    
        /**
        * @see MProgressDialogCallback mixin for more details.
        */
        void DialogDismissedL( TInt aButtonId );

    private: // internal helper methods
    
        /**
        * Shows a dialog asking the user if he/she wants to have the available
        * connection methods automatically checked for.
        * @return ETrue if the user wants the conn methods be automatically
        * discovered, EFalse if he/she wants to discover them manually.
        */
        TBool AutoCheckForCmsL() const;

        /**
        * If automatic CM detection has failed, the user is prompted a dialog
        * asking if he/she wants to proceed with manual configuration.
        * @return ETrue if the user wants to proceed with manual configuration,
        * EFalse otherwise.
        */
        TBool ManualCheckForCmsL() const;

        /**
        * Checks for availability of packet data and WLAN bearer types. Shows
        * a wait dialog until discovery is not complete.
        * @param aCoverageArray This array is supposed to hold the UIDs of
        * bearers that have network coverage for the moment.
        */
        void CheckForCmsL( RArray<TUint32>& aCoverageArray );
        
        
        /**
         * Finds the target destination to which the currently creted VPN
         * connection method points. It can be a destination or the destination
         * which includes the connection method to which the VPN points.
         * @param aPlugin VPN plugin.
         * @return the Id of the destination 
         */
        TUint32 FindTargetDestinationL( CCmPluginBase* aPlugin );

        /**
         * Finds the parent destination of a connection method.
         * @param Id of the connection method
         * @return Id of the destination which contains cmId 
         */
        TUint32 FindParentDestinationL( TUint32 aCmId );

    private: // data
    
        CAknWaitDialog* iCheckConnDlg;  ///< Owned.
        TBool iCheckConnDlgCancelled;
        
        CCmManagerImpl& iCmManager;     ///< Only a reference == not owned.
        CActiveSchedulerWait    iWait;
    };

#endif // T_TCMWIZARD_H