williamr@2: /*
williamr@2: * Copyright (c) 2004-2006 Nokia Corporation and/or its subsidiary(-ies). 
williamr@2: * All rights reserved.
williamr@2: * This component and the accompanying materials are made available
williamr@2: * under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
williamr@2: * which accompanies this distribution, and is available
williamr@2: * at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
williamr@2: *
williamr@2: * Initial Contributors:
williamr@2: * Nokia Corporation - initial contribution.
williamr@2: *
williamr@2: * Contributors:
williamr@2: *
williamr@2: * Description:       Processing instruction node functions
williamr@2: *
williamr@2: */
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: #ifndef XMLENGINE_PROCESSINGINSTRUCTION_H_INCLUDED
williamr@2: #define XMLENGINE_PROCESSINGINSTRUCTION_H_INCLUDED
williamr@2: 
williamr@2: #include "xmlengnode.h"
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2:  * Instance of TXmlEngProcessingInstruction class represents an XML processing 
williamr@2:  * instruction in the DOM tree.
williamr@2:  * 
williamr@2:  * @lib XmlEngineDOM.lib
williamr@2:  * @since S60 v3.1
williamr@2:  */
williamr@2: class TXmlEngProcessingInstruction : public TXmlEngNode
williamr@2: {
williamr@2:   public:
williamr@2:     /**
williamr@2:      * Default constructor
williamr@2:      *
williamr@2:      * @since S60 v3.1
williamr@2:      */
williamr@2: 	inline TXmlEngProcessingInstruction();
williamr@2:     
williamr@2:     /**
williamr@2:      * Get target of processing instruction.
williamr@2:      *
williamr@2:      * @since S60 v3.1
williamr@2:      * @return "Target" part of a processing instruction
williamr@2:      *
williamr@2:      * @code
williamr@2:      *    <?target data?>
williamr@2:      * @endcode
williamr@2:      * @see http://www.w3.org/TR/2004/REC-xml-20040204/#sec-pi
williamr@2:      */
williamr@2:     IMPORT_C TPtrC8 Target() const;
williamr@2: 
williamr@2:     /**
williamr@2:      * Get data of processing instruction.
williamr@2:      *
williamr@2:      * @since S60 v3.1
williamr@2:      * @return "Data" part of a processing instruction
williamr@2:      *
williamr@2:      * @code
williamr@2:      *    <?target data?>
williamr@2:      * @endcode
williamr@2:      * @see http://www.w3.org/TR/2004/REC-xml-20040204/#sec-pi
williamr@2:      */
williamr@2:     IMPORT_C TPtrC8 Data() const;
williamr@2: 
williamr@2:     /**
williamr@2:      * Sets data part of processing instruction
williamr@2:      *
williamr@2:      * @since S60 v3.1
williamr@2:      * @param aData New data part of processing instruction
williamr@2:      * @note PI contents should not contain "?>" sequence
williamr@2:      */
williamr@2:     IMPORT_C void SetDataL(const TDesC8& aData);
williamr@2: 
williamr@2: protected:
williamr@2:     /**
williamr@2:      * Constructor
williamr@2:      *
williamr@2:      * @since S60 v3.1
williamr@2:      * @param aInternal processing instruction pointer
williamr@2:      */
williamr@2: 	inline TXmlEngProcessingInstruction(void* aInternal);
williamr@2: };
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: #include "xmlengprocessinginstruction.inl"
williamr@2: #endif /* XMLENGINE_PROCESSINGINSTRUCTION_H_INCLUDED */