/*
* 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: 
*     Holds Email setting item
*
*/


#ifndef CWPEmailItem_H
#define CWPEmailItem_H

// INCLUDES
#include <MWPVisitor.h>
#include <e32base.h>

// FORWARD DECLARATIONS
class CWPCharacteristic;

//E-mail Notification and retrieval parameters
_LIT( KParamEMN, "EMN" );
_LIT( KParamCS, "CS" );
_LIT( KParamLMS, "LMS" );
_LIT( KParamRETRMODE, "RETR-MODE" );
_LIT( KParamRETRSIZE, "RETR-SIZE" );
_LIT( KParamPOLL, "POLL" );
_LIT( KParamONLINE, "ONLINE" );


// CLASS DECLARATION

/**
 * CWPEmailItem handles Email settings.
 * @since 2.0
 */ 
class CWPEmailItem : public CBase, public MWPVisitor
	{
	public:  // Constructors and destructor

        /**
        * Creates Email setting item
		* @since 2.0
        * @return self
        */
		static CWPEmailItem* NewL();
        static CWPEmailItem* NewLC();

        /**
        * Destructor.
        */
		~CWPEmailItem();

    public: // New functions
		
		/**
        * Get parameter value. Must be one of enumeration
		* TWPParameterID.
		* @since 2.0
		* @return param value or KNullDesC if not found
		*/
		const TDesC& ParameterValue(TInt aParamID) const;
		       
        /**
        * Get associated IAP name for email settings.
		* @since 2.0
        * @return Internet Access Point name.
        */
        HBufC* AssociatedIapNameL();
        
        /**
        * Get associated IAP id
        * @since 2.0
        * @return IAP id or Zero if not found
        */
		TUint32 AssociatedIapId();

        /**
        * Check that current settings are valid
        * since 2.0
        * @return ETrue if settings are valid
        */
        TBool IsValid() const;
        
        /**
        * Get parameter value. Must be one of enumeration
        * TWPParameterID.
        * @since 2.0
        * @return param value or KNullDesC if not found
        */
        const TDesC& ParameterValue(const TDesC& aParamName);


	public: // From MWPVisitor

		void VisitL(CWPCharacteristic& aCharacteristic);
		void VisitL(CWPParameter& aParameter);
		void VisitLinkL(CWPCharacteristic& aCharacteristic );


	private:  // constructor 

        /**
        * C++ default constructor.
        */
        CWPEmailItem();

        /**
        * 2nd phase constructor
        */
		void ConstructL();
		
	private:  // Data
        
        /**
		* Ref: Array to Mail setting parameters
		**/ 
		CArrayPtr<CWPParameter>* iEmailSettingParams;

        ///Ref:to the IAP settings
        CWPCharacteristic* iNapDef;

    
    private: // for testing use
        friend class T_CWPEmailItem;
		
	};

#endif	// CWPEmailItem_H
            
// End of File