/*

* Copyright (c) 2010 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: 

* Stub for EAP WIZARD testing: EAP QT configuration validator interface.

*/

#ifndef EAPQTVALIDATOR_H

#define EAPQTVALIDATOR_H

// System includes

#include <QVariant>

// User includes

// Forward declarations

class HbLineEdit;

// External data types

// Constants

// Class declaration

/*!

 * @addtogroup group_eap_config_api

 * @{

 */

/*

 * Eap Qt Validator interface. This interface provides a method to configure

 * the editor to use required constraints, hints, editor classes and so one

 * depending on the EAP type and the configuration identifier.

 * See updateEditor() method for further details.

 * 

 * validate() method checks that the content and format are valid for

 * given configuration parameter.

 * 

 * An instance of a validator is created with

 * EapQtConfigInterface::validatorEap() method.

 */

class EapQtValidator

{

public:

    // Data types

    /*

     * Validation status. Can be extended.

     */

    enum Status {

        /// Ok

        StatusOk = 0,

        /// Content is invalid

        StatusInvalid,

        /// The length is not valid

        StatusInvalidLength,

        /// Invalid characters detected

        StatusInvalidCharacters,

        /// Input is too short

        StatusTooShort, 

        /// Input is too long

        StatusTooLong,  

    };

    EapQtValidator() {};

    virtual ~EapQtValidator() {};

    /*!

     * Validates the given input \a value.

     *

     * @param value Value to be validated

     * 

     * @return Status code.

     */

    virtual Status validate(const QVariant &value) = 0;

    /*!

     * Sets required configurations to the line edit.

     * 

     * Configurations depend on given EAP type and the configuration

     * identifire which was used to instantiate the validator.

     * 

     * @param edit LineEdit to be updated.

     */

    virtual void updateEditor(HbLineEdit* const edit) = 0;

private:

    Q_DISABLE_COPY(EapQtValidator)

};

/*! @} */

#endif