/*
* Copyright (c) 2005 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:   XDM node attribute
*
*/




#ifndef __XDMNODEATTRIBUTE__
#define __XDMNODEATTRIBUTE__

#include <e32base.h>
#include "XdmDocumentNode.h"

class CXdmEngine;

//CLASS DECLARATION
class CXdmNodeAttribute : public CXdmDocumentNode
    {
    public:
        
        /**
        * Return the value of this attribute
        *
        * NOTE! The name of an attribute is retrieved through a call
        *       to the NodeName() member function in the base class. 
        *
        * @return TPtrC8 The value of this attribute
        */     
        IMPORT_C TPtrC AttributeValue() const;

        /**
        * Return the value of this attribute
        *
        * @return HBufC8* The value of this attribute
        */     
        IMPORT_C HBufC8* EightBitValueLC() const;
        
        /**
        * Return the escaped value of this attribute
        *
        * @return HBufC8* The value of this attribute
        */     
        IMPORT_C HBufC8* EscapedValueLC() const;
        
        /**
        * Set the value of this attribute
        *
        * @param TDesC8& Value of the attribute
        * @return void
        */     
        IMPORT_C void SetAttributeValueL( const TDesC& aAttributeValue );
        
        /**
        * Set the value of this attribute
        *
        * @param TDesC8& Value of the attribute
        * @return void
        */     
        IMPORT_C void SetAttributeValueL( const TDesC8& aAttributeValue );
        
        /**
        * The type of this element: an element or an attribute
        *
		* @return TXdmElementType* 
        */
        IMPORT_C virtual TXdmElementType ElementType() const;
          
        /**
        * Destructor.
        */      
        IMPORT_C virtual ~CXdmNodeAttribute();

    protected:  //Methods
        
        /**
        * Symbian OS constructor for derived classes.
        *
        * @param CXdmEngine& Reference to the engine
        * @param MXdmNodeFactory* Reference to the node factory
        */     
        IMPORT_C CXdmNodeAttribute( CXdmEngine& aXdmEngine,
                                    MXdmNodeFactory& aNodeFactory );
                                    
        /**
        * Symbian OS constructor for derived classes.
        *
        * @param CXdmEngine& Reference to the engine
        * @param MXdmNodeFactory* Reference to the node factory
        * @param CXdmDocumentNode* Pointer to the parent element
        */    
        IMPORT_C CXdmNodeAttribute( CXdmEngine& aXdmEngine,
                                    MXdmNodeFactory& aNodeFactory,
                                    CXdmDocumentNode* aParentNode );
        
        /**
        * Symbian OS base class constructor.
        *
        * @param TDesC& Name of the attribute
        * @return void
        */     
        IMPORT_C void BaseConstructL( const TDesC& aAttributeName );
    
    private:
      
        /**
        * Set the value of this element
        *
        * @param TDesC Attribute name
        * @return void
        */   
        void SetValueL( const TDesC& aAttributeName );

    private:  //Data
        
        HBufC*                         iAttributeValue;
    };

#endif      //__XDMNODEATTRIBUTE__
            
// End of File