williamr@4: // Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@4: // All rights reserved.
williamr@4: // This component and the accompanying materials are made available
williamr@4: // under the terms of "Eclipse Public License v1.0"
williamr@4: // which accompanies this distribution, and is available
williamr@4: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@4: //
williamr@4: // Initial Contributors:
williamr@4: // Nokia Corporation - initial contribution.
williamr@4: //
williamr@4: // Contributors:
williamr@4: //
williamr@4: // Description:
williamr@4: // Inline functions specyfic for element node
williamr@4: // Default constructor
williamr@4: //
williamr@2: 
williamr@2: inline TXmlEngElement::TXmlEngElement():TXmlEngNode(NULL) {}
williamr@2: 
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: // Constructor
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: //
williamr@2: inline TXmlEngElement::TXmlEngElement(void* aInternal): TXmlEngNode(aInternal) {}
williamr@2: 
williamr@2: 
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: // Creates new attribute node using namespace of its parent element (this element),
williamr@2: // sets attribute's value and links it as the last attribute of the element
williamr@2: //
williamr@2: // @param aName	- Local name of attribute 
williamr@2: // @param aValue - Value to set for new attribute or NULL (sets value to "")
williamr@2: // @return A handler to the newly created attribute node;
williamr@2: //
williamr@2: // For more hints how to use it refer to AddNewAttributeL(const TDesC8&,const TDesC8&)
williamr@2: //		
williamr@2: // @note	
williamr@2: // 	- No checks are made that attribute with such name exists
williamr@2: // 	- if namespace of the parent element is default (i.e. bound prefix is NULL),
williamr@2: // 	  then temporary prefix will be used and bound to the same namespace URI as elements
williamr@2: // 	  (It is due to the fact that default namespaces do not spread on unprefixed attributes,
williamr@2: // 	   see http://w3.org/TR/REC-xml-names/#defaulting)
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: //
williamr@2: inline TXmlEngAttr TXmlEngElement::AddNewAttributeSameNsL(const TDesC8& aName, const TDesC8& aValue)
williamr@2:     {
williamr@2:     return AddNewAttributeL(aName, aValue, NamespaceDeclaration());
williamr@2:     }
williamr@2: 
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: // @return Default namespace in the scope of the element
williamr@2: //
williamr@2: // NULL TXmlEngNamespace means that element with no prefix have no namespace associated
williamr@2: // because no default namespace was declared or default namespace was undeclared with <b>xmlns=""</b>
williamr@2: //
williamr@2: // Equivalent to LookupNamespaceByPrefixL() with NULL (or "") prefix provided
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: //
williamr@2: inline TXmlEngNamespace TXmlEngElement::DefaultNamespaceL() const
williamr@2:     {
williamr@2:     return LookupNamespaceByPrefixL(KNullDesC8);
williamr@2:     }
williamr@2: 
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: // Specialized version of TXmlEngNode::CopyL()
williamr@2: //
williamr@2: // @return Deep copy of the element.
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: //
williamr@2: inline TXmlEngElement TXmlEngElement::CopyL() const
williamr@2:     {return TXmlEngNode::CopyL().AsElement();}
williamr@2: 
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: // Removes all element contents: child nodes, attributes and namespace declarations
williamr@2: //
williamr@2: // @see RemoveChildren(), RemoveAttributes(), RemoveNamespaceDeclarations();
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: //
williamr@2: inline void TXmlEngElement::ClearElement()
williamr@2:     {
williamr@2:     RemoveChildren();
williamr@2:     RemoveAttributes();
williamr@2:     RemoveNamespaceDeclarations();
williamr@2:     }
williamr@2: 
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: //
williamr@2: 
williamr@2: 
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: // Returns TRUE if the element holds an attribute with such namespace URI and name.
williamr@2: //
williamr@2: // Same result gives AttributeNodeL(uri,name).NotNull()
williamr@2: // -------------------------------------------------------------------------------------
williamr@2: //
williamr@2: inline TBool TXmlEngElement::HasAttributeL(const TDesC8& aLocalName, const TDesC8& aNamespaceUri) const
williamr@2: 	{return AttributeNodeL(aLocalName, aNamespaceUri).NotNull();}
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: