/*
* 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:   SIMPLE attribute
*
*/




#ifndef simpleattribute_H
#define simpleattribute_H

#include <e32std.h>
// #include "simplecommon.h"
#include "msimpleattribute.h"

// FORWARD DECLARATION
class CSenBaseAttribute;


/**
 *  CSimpleAttribute
 *
 *  SIMPLE attribute.
 *
 *  @lib simplexmlutils
 *  @since S60 v3.1
 */

class CSimpleAttribute : public CBase, public MSimpleAttribute
    {

public:


    /**
     * Two-phased constructor.
     * @since S60 v3.1
     * @param aName:    Name of the attribute
     * @param aValue:   Attribute's value.
     * @return CSimpleAttribute
     */
    static CSimpleAttribute* NewL(
        const TDesC8& aName,
        const TDesC8& aValue );

    /**
     * Two-phased constructor.
     * @since S60 v3.1
     */
    static CSimpleAttribute* NewL(
        CSenBaseAttribute* aAttr );

    /**
     * Destructor.
     */
    virtual ~CSimpleAttribute();

    /**
     * @return Base class implementation
     */
    CSenBaseAttribute* BaseElement();

// from base class MSimpleAttribute

    /**
     * From MSimpleAttribute
     * Getter for the attribute name.
     * @since Series60 3.1
     * @return the attribute name.
     */
    const TDesC8& Name();

    /**
     * From MSimpleAttribute
     * Getter for the attribute value.
     * @since Series60 3.1
     * @return the attribute value.
     */
    const TDesC8& Value();

    /**
     * From MSimpleAttribute
     * Getter for the attribute value in UNICODE.
     * @since Series60 3.1
     * @return the attribute value. Ownership is transferred.
     */
    HBufC* ValueUniLC();

    /**
     * From MSimpleAttribute
     * Setter for the attribute value.
     * This makes conversion from 16-bit to 8-bit.
     *
     * @since Series60 3.1
     * @param aValue: value to be set
     */
    void SetValueL( const TDesC& aValue );

private:

    /**
     * Two-phase constructor
     * @param aName:    Name of the attribute
     * @param aValue:   Attribute's value.
     */
    void ConstructL(
        const TDesC8& aName,
        const TDesC8& aValue );

    /**
     * Two-phase constructor
     * @param aAttr:    Base element
     */
    void ConstructL(
        CSenBaseAttribute* aAttr );

    /**
     * constructor
     */
    CSimpleAttribute();


private: // data

    /**
     * Base element when created from scratch
     * Own.
     */
    CSenBaseAttribute*    iBase;

    /**
     * Base element when only reference to base element
     * Not own.
     */
    CSenBaseAttribute*    iRef;

    };

#endif      // simpleattribute_H

// End of File