/*
* Copyright (c) 2004-2006 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* 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
* which accompanies this distribution, and is available
* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: Text node functions
*
*/
#ifndef XMLENGINE_TEXT_H_INCLUDED
#define XMLENGINE_TEXT_H_INCLUDED
#include "xmlengcharacterdata.h"
/**
* The TXmlEngTextNode interface inherits from TXmlEngCharacterData and represents the textual content
* (termed "character data" in XML) of an Element or TXmlEngAttr.
*
* If there is no markup inside an element's content, the text is contained in a single object
* of the TXmlEngTextNode interface that is the only child of the element. If there is markup,
* it is parsed into the information items (elements, comments, etc.) and TXmlEngTextNode nodes that
* form the list of children of the element.
*
* When a document is first made available via the DOM, there is only one TXmlEngTextNode node for each
* block of text. Users may create adjacent TXmlEngTextNode nodes that represent the contents of a given
* element without any intervening markup, but should be aware that there is no way to
* represent the separations between these nodes in XML or HTML, so they will not (in general)
* persist between DOM editing sessions.
*
* No lexical check is done on the content of a TXmlEngTextNode node and, depending on its position in
* the document, some characters must be escaped during serialization using character references;
* e.g. the characters "<&" if the textual content is part of an element or of an attribute,
* the character sequence "]]>" when part of an element, the quotation mark character " or
* the apostrophe character ' when part of an attribute.
*
* <b>DOM Level 3 spec:</b>
* <p>http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#ID-1312295772
*
* @lib XmlEngineDOM.lib
* @since S60 v3.1
*/
class TXmlEngTextNode : public TXmlEngCharacterData
{
public:
/**
* Default constructor
*
* @since S60 v3.1
*/
inline TXmlEngTextNode();
/**
* Check if element content is whitespace.
*
* @since S60 v3.1
* @return TRUE if is only whitespace
*/
IMPORT_C TBool IsElementContentWhitespace() const;
protected:
/**
* Constructor
*
* @since S60 v3.1
* @param aInternal Text node pointer
*/
inline TXmlEngTextNode(void* aInternal);
};
#include "xmlengtext.inl"
#endif /* XMLENGINE_TEXT_H_INCLUDED */