/*

* Copyright (c) 2004-2007 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: MPM class used for agent dialog initiation

*

*/

/**

@file mpmdialog.h

Mobility Policy Manager agent dialog initiation class.

*/

#ifndef MPMDIALOG_H

#define MPMDIALOG_H

//  INCLUDES

#include <e32base.h>

#include <agentdialog.h>

#include "mpmiapselection.h"

#include "mpmdialogbase.h" 

// CLASS DECLARATION

/**

*  MPM dialog initiation class definition.

*

*  @lib MPMServer.exe

*  @since 3.0

*/

class CMPMDialog : protected CMPMDialogBase

    {    

public:

    /**

     * Two-phased constructor.

     * @param aCommDbConnPref Connection preferences

     */

    static CMPMDialog* NewL( CMPMIapSelection&          aIapSelection,

                             const RAvailableIAPList&   aIAPList,

                             TUint32                    aBearerSet,

                             CArrayPtrFlat<CMPMDialog>& aQueue,

                             CMPMServer&                aServer );

    /**

     * Destructor.

     */

    virtual ~CMPMDialog();

    /**

     * Write sort snap information to publish and subscribe.

     * 

     * Publish and subscribe is used as there is otherwise circular 

     * reference between MPM and connection dialogs which causes 

     * @since 3.2 

     */

    void PublishSortSnapInfoL();

protected: // Functions from base classes

    /**

     * Called from the Base class implementation 

     * when dialog is started. In the current

     * call stack it's possible to query aDlg for 

     * more information and after that pointer is 

     * invalid.

     */

    virtual void Start( CMPMDialogBase* aDlg = NULL );

    /**

     * From CActive. Cancels UI dialog.

     * @since 3.0

     */        

    void DoCancel();

    /**

     * From CActive. Run when UI dialog finished.

     * @since 3.0

     */               

    void RunL();

    /**

     * From CActive. Run if RunL leaves.

     * @since 3.0

     * @param aError Error that caused leave.

     * @return KErrNone

     */

    TInt RunError( TInt aError );

private: // New methods

    /**

     * Initiates a UI dialog towards Agent Dialog Server.

     * @since 3.0

     */

    void InitSelectConnection();

    /**

     * C++ default constructor.

     * @param aCommDbConnPref Connection preferences

     */

    CMPMDialog( CMPMIapSelection&           aIapSelection,

                TUint32                     aBearerSet,

                CArrayPtrFlat<CMPMDialog>&  aQueue,

                CMPMServer&                 aServer );

    /**

     * 2nd phase constructor.

     */

    void ConstructL( const RAvailableIAPList& aIAPList );

    /**

     * Copies aOrigin to aCopy. 

     * @since 3.2 

     * @param aOrigin Original RAvailableIAPList.

     * @param aCopy Copy RAvailableIAPList.

     * @return KErrNone if successful, otherwise one of the 

     * system-wide error codes.

     */

    TInt CopyArray( const RAvailableIAPList& aOrigin, 

                    RAvailableIAPList&       aCopy );

    /**

     * Clean sort snap information from publish and subscribe.

     * 

     * @since 3.2 

     */

    void CleanSortSnapInfo();

private: // Data

    // Agent Dialog server

    RGenConAgentDialogServer    iDlgServ;

    // Iap selection object reference

    CMPMIapSelection&           iIapSelection;

    // SNAP or IAP id

    TUint32                     iSnapOrIAPId;

    // Bearer set as a combination of

    // TExtendedConnPref::TExtendedConnBearer values.

    TUint32                     iBearerSet;

    // Handle to server class

    CMPMServer&                 iServer;

    RAvailableIAPList           iIAPList;

    };

#endif // MPMDIALOG_H

// End of file