// Copyright (c) 2001-2009 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:
// This file contains the declaration of the CMDXMLDocumentElement class.
// 
//

/**
 @file
*/

#ifndef __GMXMLDOCUMENTELEMENT_H__
#define __GMXMLDOCUMENTELEMENT_H__

#include <e32base.h>
#include <gmxmlelement.h>

class CMDXMLDocumentElement : public CMDXMLElement
/** A dummy XML element for use as the top level element by the document.

This is required to handle parsing badly-formed XML documents. 
@publishedPartner
@released
*/
{
public:
	/** Allocates and constructs a new CMDXMLDocumentElement, leaving the object on 
	the cleanup stack.
	
	@param aOwnerDocument Pointer to the document at the root of the DOM tree
	@leave KErrNoMemory Out of memory
	@return The new CMDXMLDocumentElement */
	IMPORT_C static CMDXMLDocumentElement* NewLC( CMDXMLDocument* aOwnerDocument);

	/** Allocates and constructs a new CMDXMLDocumentElement.
	
	@param aOwnerDocument Pointer to the document at the root of the DOM tree
	@leave KErrNoMemory Out of memory
	@return The new CMDXMLDocumentElement */
	IMPORT_C static CMDXMLDocumentElement* NewL( CMDXMLDocument* aOwnerDocument);

	/** Destructor. */
	IMPORT_C virtual ~CMDXMLDocumentElement();


protected: //construction
	/*
	 * Constructor
	 * @param aOwnerDocument Pointer to the document at the root of the DOM tree - if NULL then assume this is the root
	 */
	CMDXMLDocumentElement( CMDXMLDocument* aOwnerDocument );
};


#endif