// 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 memory chunk data functions

//

/**

 @file

 @publishedAll

 @released

*/

#ifndef XMLENGCHUNKCONTAINER_H

#define XMLENGCHUNKCONTAINER_H

#include <xml/dom/xmlengdatacontainer.h>

/**

This class stores a reference to a RChunk handle within the DOM tree.  No

ownership is tranferred and the client is expected to close the RChunk when it

is no longer required.  Multiple chunk containers can refer to the same RChunk,

regardless of whether the offsets overlap.

This class is most often instantiated by calling

RXmlEngDocument::CreateChunkContainerL().

Sample code for creating chunk container:

@code  

     RXmlEngDOMImplementation domImpl;

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

     RXmlEngDocument iDoc; 

     // create document element

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

     // create RChunk object with chunkName name and size

     RChunk chunk;

     chunk.CreateGlobal(chunkName, size, maxSize);

     CleanupClosePushL(chunk); 

     // create chunk container from Rchunk object with offset to the 

     // binary data in chunk and binary data size in chunk (binarySize) 

     TXmlEngChunkContainer binData = iDoc.CreateChunkContainerL(

								cid,chunk,offset,binarySize); 

     // append chunkcontainer to the dom tree          

     TXmlEngNode ref = iDoc.DocumentElement().AppendChildL(binData);

     // closing all opened objects

     CleanupStack::PopAndDestroy(); //chunk

     iDoc.Close();              

     domImpl.Close();

@endcode 

*/

class TXmlEngChunkContainer : public TXmlEngDataContainer

{

public:

    /** Get memory chunk reference

    @return Memory chunk reference

    */

    IMPORT_C RChunk& Chunk() const;

    /** Get offset of binary data in memory chunk

    @return Offset of binary data in memory chunk

    */

    IMPORT_C TUint ChunkOffset() const;   

protected:

    /** Default constructor */

	inline TXmlEngChunkContainer(); 

    /**

    Constructor

    @param aInternal node pointer

    */

	inline TXmlEngChunkContainer(void* aInternal);

};

#include <xml/dom/xmlengchunkcontainer.inl>

#endif /* XMLENGCHUNKCONTAINER_H */