/*

* 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:  IMSSettingsItemApprover.h

*

*/

#ifndef IMSSETTINGSITEMAPPROVER_H

#define IMSSETTINGSITEMAPPROVER_H

// INCLUDES

#include <e32base.h>

#include "MuiuDynamicSettingItemBase.h" // CMuiuSettingBase

#include <msvapi.h>                     // CMsvSession

#include <muiuflagger.h>                // CMuiuFlags

#include "MuiuDynamicSettingsDialog.h"  // TMuiuPageEventResult

#include "ComDbUtl.h"                   // CMsvCommDbUtilities

#include "IMSSettingsNoteUi.h"          // CIMSSettingsNoteUi

#include "IMSSettingsItemApprover.h"    // CIMSSettingsItemApprover

#include "IMSSettingsBaseUi.h"          // CIMSSettingsBaseUi

// CONSTANTS

enum TIMSApproverFlags

    {

    // Indicates that the item contains unprepared value

    EIMSApproverGenerate = 15

    };

enum TIMSApproverEvent

    {

    EIMSApproverNoEvent = 0,

    EIMSApproverRemoveAlwaysOnline,

    EIMSApproverRemoveOmaEmn

    };

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class CImumInternalApi;

class CImumInSettingsData;

// CLASS DECLARATION

/**

*  ?one_line_short_description.

*  ?other_description_lines

*

*  @lib ?library

*  @since S60 3.0

*/

class CIMSSettingsItemApprover : public CBase

    {

    public: // Constructors and destructor

        /**

        * Destructor

        * @since S60

        */

        ~CIMSSettingsItemApprover();

        /**

        *

        * @since S60

        */

        static CIMSSettingsItemApprover* NewL(

            CImumInternalApi& aMailboxApi,

            CMsvCommDbUtilities& aCommsDb,

            CIMSSettingsNoteUi& aNoteUi,

            CIMSSettingsBaseUI& aDialog );

        /**

        *

        * @since S60

        */

        static CIMSSettingsItemApprover* NewLC(

            CImumInternalApi& aMailboxApi,

            CMsvCommDbUtilities& aCommsDb,

            CIMSSettingsNoteUi& aNoteUi,

            CIMSSettingsBaseUI& aDialog );

    public: // New functions

        /**

        *

        * @since S60 3.0

        */

        TMuiuPageEventResult EvaluateText(

            TIMSApproverEvent& aEvent,

            const CMuiuSettingBase& aBaseItem,

            TDes& aNewText );

        /**

        *

        * @since S60 3.0

        */

        TMuiuPageEventResult EvaluateValue(

            TIMSApproverEvent& aEvent,

            const CMuiuSettingBase& aBaseItem,

            TInt& aNewValue );

    public: // Functions from base classes

    protected:  // New virtual functions

    protected:  // New functions

    protected:  // Functions from base classes

    private: // Constructors

        /**

        *

        * @since S60

        */

        CIMSSettingsItemApprover(

            CImumInternalApi& aMailboxApi,

            CMsvCommDbUtilities& aCommsDb,

            CIMSSettingsNoteUi& aNoteUi,

            CIMSSettingsBaseUI& aDialog );

        /**

        *

        * @since S60

        */

        void ConstructL();

    private:  // New virtual functions

    private:  // New functions

        // COMMON ITEM VALIDATION

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors ValidateType(

            const CMuiuSettingBase& aBaseItem,

            TDes& aNewText,

            TInt& aNewValue );

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors EvaluateWizardItems(

            TIMSApproverEvent& aEvent,

            const CMuiuSettingBase& aBaseItem,

            TDes& aNewText,

            TInt& aNewValue );

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors EvaluateSettingItems(

            TIMSApproverEvent& aEvent,

            const CMuiuSettingBase& aBaseItem,

            TDes& aNewText,

            TInt& aNewValue );

        /**

        *

        * @since S60 3.0

        */

        TMuiuPageEventResult EvaluateItem(

            TIMSApproverEvent& aEvent,

            const CMuiuSettingBase& aBaseItem,

            TDes& aNewText,

            TInt& aNewValue );

        /**

        *

        * @since S60 3.0

        */

        TBool IsItemFilled(

            const CMuiuSettingBase& aBaseItem,

            const TInt aLength );

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors ValidateText(

            const CMuiuSettingBase& aBaseItem,

            const TDesC& aNewText );

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors ValidateValue(

            const CMuiuSettingBase& aBaseItem,

            TInt& aNewValue );

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors ValidateRadioButtons(

            const TInt aNewValue );

        // SPESIFIC ITEM VALIDATION

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors EvaluateAccountName(

            const CMuiuSettingBase& aBaseItem,

            TDes& aNewText );

        /**

        *

        * @since Series60 3.0

        */

        TIMSErrors EvaluateServerAddress(

            const CMuiuSettingBase& aBaseItem,

            const TDesC& aNewText );

        /**

        *

        * @since Series60 3.0

        */

        TIMSErrors EvaluateEmailAddress(

            const CMuiuSettingBase& aBaseItem,

            const TDesC& aNewText );

        /**

        *

        * @since Series60 3.0

        */

        TIMSErrors EvaluateInternetAccessPoint(

            const CMuiuSettingBase& aBaseItem,

            TInt& aNewValue );

        // ITEM VALIDATION UTILITIES

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors EvaluateUsernameOrPassword(

            TIMSApproverEvent& aEvent,

            TDes& aNewText );

        /**

         * Evaluates free text fields that have no special

         * restrictions.

         *

         * @since S60 5.0

         */

        TIMSErrors EvaluateFreeText( TDes& aNewText );

        // Always Online and OMA EMN checks

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors CheckItemOnlineSettingsCheckTurnOn(

            TIMSApproverEvent& aEvent,

            const TInt aNewValue,

            TBool aIsEmn );

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors CheckItemOnlineSettingsCheckTurnOnL(

            TIMSApproverEvent& aEvent,

            TBool aIsEmn );

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors CheckItemAoCountOkL();

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors CheckItemAoAccessPointOkL();

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors CheckItemAoOmaEmnOffL( TBool aIsEmn );

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors CheckItemAoUsernameAndPasswordL();

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors CheckItemAoConnectionTypeL();

        /**

        *

        * @since S60 3.0

        */

        TIMSErrors CheckItemAOFixFetchL();

    private:  // Functions from base classes

    public:     // Data

    protected:  // Data

    private:    // Data

        // Internal mail API implementation

        CImumInternalApi&   iMailboxApi;

        // CommsDb utils

        CMsvCommDbUtilities& iCommsDbUtils;

        // Class to handle notes in UI

        CIMSSettingsNoteUi& iNoteUi;

        // The ownerdialog item

        CIMSSettingsBaseUI& iDialog;

        //

        TMuiuSettingsText*  iTempText;

    };

#endif // IMSSETTINGSITEMAPPROVER_H

// End of File