1 // Copyright (c) 2001-2009 Nokia Corporation and/or its subsidiary(-ies).

     2 // All rights reserved.

     3 // This component and the accompanying materials are made available

     4 // under the terms of "Eclipse Public License v1.0"

     5 // which accompanies this distribution, and is available

     6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".

     7 //

     8 // Initial Contributors:

     9 // Nokia Corporation - initial contribution.

    10 //

    11 // Contributors:

    12 //

    13 // Description:

    14 // This file contains the declaration of the CMDXMLDocumentElement class.

    15 // 

    16 //

    17 

    18 /**

    19  @file

    20 */

    21 

    22 #ifndef __GMXMLDOCUMENTELEMENT_H__

    23 #define __GMXMLDOCUMENTELEMENT_H__

    24 

    25 #include <e32base.h>

    26 #include <gmxmlelement.h>

    27 

    28 class CMDXMLDocumentElement : public CMDXMLElement

    29 /** A dummy XML element for use as the top level element by the document.

    30 

    31 This is required to handle parsing badly-formed XML documents. 

    32 @publishedPartner

    33 @released

    34 */

    35 {

    36 public:

    37 	/** Allocates and constructs a new CMDXMLDocumentElement, leaving the object on 

    38 	the cleanup stack.

    39 	

    40 	@param aOwnerDocument Pointer to the document at the root of the DOM tree

    41 	@leave KErrNoMemory Out of memory

    42 	@return The new CMDXMLDocumentElement */

    43 	IMPORT_C static CMDXMLDocumentElement* NewLC( CMDXMLDocument* aOwnerDocument);

    44 

    45 	/** Allocates and constructs a new CMDXMLDocumentElement.

    46 	

    47 	@param aOwnerDocument Pointer to the document at the root of the DOM tree

    48 	@leave KErrNoMemory Out of memory

    49 	@return The new CMDXMLDocumentElement */

    50 	IMPORT_C static CMDXMLDocumentElement* NewL( CMDXMLDocument* aOwnerDocument);

    51 

    52 	/** Destructor. */

    53 	IMPORT_C virtual ~CMDXMLDocumentElement();

    54 

    55 

    56 protected: //construction

    57 	/*

    58 	 * Constructor

    59 	 * @param aOwnerDocument Pointer to the document at the root of the DOM tree - if NULL then assume this is the root

    60 	 */

    61 	CMDXMLDocumentElement( CMDXMLDocument* aOwnerDocument );

    62 };

    63 

    64 

    65 #endif