/*
* 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