diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/xmlengtext.h --- a/epoc32/include/xmlengtext.h Tue Nov 24 13:55:44 2009 +0000 +++ b/epoc32/include/xmlengtext.h Tue Mar 16 16:12:26 2010 +0000 @@ -1,1 +1,90 @@ -xmlengtext.h +/* +* 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. + * + * DOM Level 3 spec: + *
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 */