// Copyright (c) 2006-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:

// All file container data functions

// @file

// @publishedAll

// @released

//

#ifndef XMLENGFILECONTAINER_H

#define XMLENGFILECONTAINER_H

#include <xml/dom/xmlengdatacontainer.h>

class RFile;

/**

This class represents data stored as a RFile in the DOM tree.

The RFile container is treated in general as a text node in the DOM tree.  Data

is stored in the file system referenced by the RFile handle.

Sample code for creating a file container:

@code  

     RXmlEngDOMImplementation domImpl;

     domImpl.OpenL();        		// opening DOM implementation object 

     RXmlEngDocument iDoc; 

     // create document element

     TXmlEngElement elem = iDoc.CreateDocumentElementL(_L8("doc"));

     // create file container from file (file1 is an RFile object) and CID equals cid

     TXmlEngFileContainer binData = iDoc.CreateFileContainerL(cid, file1);

     elem.AppendChildL(binData);    // append container to the dom tree       

     iDoc.Close();               	// closing all opened objects

     domImpl.Close();

@endcode 

*/

class TXmlEngFileContainer : public TXmlEngDataContainer

{

public:

    /**

    Gets the RFile reference

    @return RFile reference

    */

    IMPORT_C RFile& File() const;

protected:

    /** Default constructor */

	inline TXmlEngFileContainer(); 

    /**

    Constructor

    @param aInternal Node pointer

    */

	inline TXmlEngFileContainer(void* aInternal);

};

#include <xml/dom/xmlengfilecontainer.inl>

#endif // XMLENGFILECONTAINER_H