/*

* 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:  Declaration of class CApSettingsDeleteOperation.

*

*/

#ifndef APSETTINGS_DELETE_OPERATION_H

#define APSETTINGS_DELETE_OPERATION_H

// INCLUDE FILES

#include <ApDataHandler.h>

#include <AknProgressDialog.h>

// CONSTANTS

// DATA TYPES

// FORWARD DECLARATION

class CActiveApDb;

class CApSettingsModel;

class CAknWaitDialog;

class CErrorUI;

// CLASS DECLARATION

/**

* Model for the access point settings ui.

*/

NONSHARABLE_CLASS( CApSettingsDeleteOperation ) : 

                    public CActive, public MProgressDialogCallback

    {

    public:

        enum TState             /// State of the finite state machine.

            {

            EProcOnDialogOn,

            EProcOffDialogOn,

            EProcOnDialogOff,

            EProcOffDialogOff

            };

    public:     // Construct / destruct

        /**

        * Two-phased constructor. Leaves on failure.

        * @param aNoteControlId The ID of the note control.

        * @param aResourceID The resource ID of the wait note dialog.

        * @param aUid The UID of the access point to delete.

        * @param aNoteText The label for the note text.

        * @return The constructed CApSettingsDeleteOperation object.

        */

        static CApSettingsDeleteOperation* NewL(

                                TInt aNoteControlId,

                                TInt aResourceID,

                                TUint32 aUid,

                                const TDesC& aNoteText

                                );

        /**

        * Destructor.

        */

        virtual ~CApSettingsDeleteOperation();

    protected:  // new functions

        /**

        * Constructor.

        * @param aNoteControlId The ID of the note control.

        * @param aResourceID The resource ID of the wait note dialog.

        * @param aUid The UID of the access point to delete.

        */

        CApSettingsDeleteOperation(

                                TInt aNoteControlId,

                                TInt aResourceID,

                                TUint32 aUid

                                );

        /**

        * Second phase constructor. Leaves on failure.

        * @param aNoteText The desired text of the note.

        * events.

        */

        void ConstructL( const TDesC& aNoteText );

    protected:  // from CActive

        /**

        * Run a step of the observer test.

        */

        void RunL();

        /**

        * Cancel protocol implementation.

        * must be present although does nothing

        * as it is pure virtual in base...

        */

        void DoCancel();

        /**

        * Callback for notification of the dismissal of the wait note dialog.

        * From MProgressDialogCallback.

        * The passed aButtonId is ignored.

        */

        virtual void DialogDismissedL( TInt aButtonId );

    public:     // new methods

        /**

        * Start the operation.

        */

        void StartL();

        /**

        * Moves into next wait round and forces RunL to execute.

        */

        void Next();

        /**

        * Starts the wait note with the current params.

        */

        void StartWaitNoteL();

        /**

        * Starts the separate delete operation thread with the current params.

        */

        void StartDeleteOperationThreadL();

        /**

        * Separate thread for the delete operation.

        * @param aPtr   A pointer to the operation to be started in the thread

        * @return The return code of the delete operation

        */

        static TInt RunDeleteThread( TAny* aPtr );

        /**

        * Separate thread for the delete operation.

        * @param aop   A pointer to the operation to be started in the thread

        * @return The return code of the delete operation

        */

        static TInt DoRunDeleteThreadL( CApSettingsDeleteOperation* aop );

        /**

        * Starts a transaction on the given database

        * @param aDb Pointer to the database object

        * @param aWrite boolean indicating whether write or read lock is needed

        * @param aRetry boolean indicating whether retry is needed

        * @return Whether the transaction is our own or not

        */

        static TBool StartTransactionLC

                            (

                            CCommsDatabase* aDb,

                            TBool aWrite,

                            TBool aRetry /* ETrue */

                            );

        /**

        * Gets write lock for the given database

        * @param aDb Pointer to the database object

        */

        static void GetWriteLockL( CCommsDatabase* aDb );

        /**

        * Cleanup function for the transaction.

        * In case of leave, it will be called and

        * transaction will be rolled back

        */

        static void RollbackTransactionOnLeave( TAny* aDb );

        /**

        * Get the list of VPN WAP Access point UID's which are linked to a 

        * specific normal internet access point WAP ID.

        * @param aDb a reference of a CCommsDatabase database object 

        * to operate on

        * @param aUid a TUint32 containing the WAP UID of the normal 

        * internet access point

        * @param aVpnList a TUint32 dynamic array passed by reference to 

        * hold the WAP UID's of the linked VPN access points.

        */

/*

        static void GetLinkedVpnAccessPointsL( CCommsDatabase& aDb,

                                        TUint32 aUid, 

                                        CArrayFixFlat<TUint32> &aVpnList );

*/

        /**

        * Reads up an integer from the given table

        * @param atable The CCommsDbTableView* table to perform the operation

        * @param aColumn The column to read

        * @param aValue A TUint32 passed by reference to hold the readed value.

        * @return TInt Error code. Returns either 0 or KErrnotFound. 

        * Leaves on any other error

        */

        static TInt ReadUintL( CCommsDbTableView* atable,

                               const TDesC& aColumn,

                               TUint32& aValue );

        /**

        * Returns the current state.

        */

        TState State(){ return iState;};

        /**

        * Set a new UID

        */

        void SetUid( TUint32 aUid ) { iUid = aUid;};

        /**

        * Set a new note-text

        */

        void SetNoteTextL( const TDesC& aNoteText );

    private:    // data

        TInt                iNoteControlId;

        TInt                iResourceID;

        TUint32             iUid;

        RThread             iDeleteOperation;

        HBufC*              iNoteText;

        CAknWaitDialog*     iWaitDialog;

        TState              iState;

        CErrorUI*           iErrorUi;

        TInt                iErr;

    };

#endif

// End of file