/*

* Copyright (c) 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:  Decleares class which check user input.

*

*/

#ifndef IPSSETUIAPPROVER_H

#define IPSSETUIAPPROVER_H

#include "ipssetuinotes.h"

class CIpsSetUi;

class CIpsSetUiItem;

/**

 *  Class to verify that user input is valid

 *

 *  @lib IpsSosSettings.lib

 *  @since FS v1.0

 */

class CIpsSetUiApprover : public CBase

    {

public: // Constructors and destructor

    /**

     * Destructor

     */

    ~CIpsSetUiApprover();

    /**

     * 2-phase contructor

     *

     * @return Approver object with client ownership.

     */

    static CIpsSetUiApprover* NewL();

    /**

     * 2-phase contructor

     *

     * @return Approver object with client ownership.

     */

    static CIpsSetUiApprover* NewLC();

public: // New functions

    /**

     * Evaluates new text.

     *

     * @param aBaseItem Item which stores the text.

     * @param aNewText New text.

     */

    TIpsSetUiEventResult EvaluateText(

        const CIpsSetUiItem& aBaseItem,

        TDes& aNewText );

    /**

     * Evaluates new value.

     *

     * @param aBaseItem Item which stores the value.

     * @param aNewValue New value.

     */

    TIpsSetUiEventResult EvaluateValue(

        const CIpsSetUiItem& aBaseItem,

        TInt& aNewValue );

private: // Constructors

    /**

     * Constructor.

     */

    CIpsSetUiApprover();

    /**

     * 2nd phase of construction.

     */

    void ConstructL();

private:  // New functions

    // COMMON ITEM VALIDATION

    /**

     * Validates the item.

     *

     * @param aBaseItem Item which stores the text or value.

     * @param aNewText New text.

     * @param aNewValue New value.

     */

    TIpsSetUiNoteErrors ValidateType(

        const CIpsSetUiItem& aBaseItem,

        TDes& aNewText,

        TInt& aNewValue );

    /**

     * Evaluates the item.

     *

     * @param aBaseItem Item which stores the text or value.

     * @param aNewText New text.

     * @param aNewValue New value.

     */

    TIpsSetUiNoteErrors EvaluateSettingItems(

        const CIpsSetUiItem& aBaseItem,

        TDes& aNewText,

        TInt& aNewValue );

    /**

     * Evaluates the item.

     *

     * @param aBaseItem Item which stores the text or value.

     * @param aNewText New text.

     * @param aNewValue New value.

     */

    TIpsSetUiEventResult EvaluateItem(

        const CIpsSetUiItem& aBaseItem,

        TDes& aNewText,

        TInt& aNewValue );

    /**

     * Checks if the item is filled.

     *

     * @param aBaseItem Item which stores the value or text.

     * @param aLength Length of the item.

     */

    TBool IsItemFilled(

        const CIpsSetUiItem& aBaseItem,

        const TInt aLength );

    /**

     * Validate the text is valid.

     *

     * @param aBaseItem Item which stores the value or text.

     * @param aNewText User input text.

     */

    TIpsSetUiNoteErrors ValidateText(

        const CIpsSetUiItem& aBaseItem,

        const TDesC& aNewText );

    /**

     * Validates the value is correct.

     *

     * @param aBaseItem Item which stores the value or text.

     * @param aNewValue User input value.

     */

    TIpsSetUiNoteErrors ValidateValue(

        const CIpsSetUiItem& aBaseItem,

        TInt& aNewValue );

    /**

     * Validates new radiobutton value.

     *

     * @param aNewValue New checked button.

     */

    TIpsSetUiNoteErrors ValidateRadioButtons(

        const TInt& aNewValue );

    // SPESIFIC ITEM VALIDATION

    /**

     *

     * @param aBaseItem Item which stores the value or text.

     */

    TIpsSetUiNoteErrors EvaluateServerAddress(

        const CIpsSetUiItem& aBaseItem,

        const TDesC& aNewText );

    /**

     *

     * @param aBaseItem Item which stores the value or text.

     */

    TIpsSetUiNoteErrors EvaluateEmailAddress(

        const CIpsSetUiItem& aBaseItem,

        const TDesC& aNewText );

private:    // Data

    /**

     * Class to handle notes in UI

     * Owned.

     */

    CIpsSetUiNotes*     iNoteUi;

    };

#endif // IPSSETUIAPPROVER_H

// End of File