Click to return to the XML (Extensible Markup Language) home page    
IXMLDOMProcessingInstruct...     IXMLHttpRequest Interface     XML DOM Interfaces    
Web Workshop  |  XML (Extensible Markup Language)

IXMLDOMText Interface


This interface represents the text content of an element or attribute.

IXMLDOMText Methods

splitText Breaks this text node into two text nodes at the specified offset, and inserts the new text node into the tree as a sibling that immediately follows this node.

Remarks

The IXMLDOMText object represents the text content of an element or attribute. XML refers to this text content as character data and distinguishes it from markup, the tags that modify that character data.

If there is no markup inside an element, that element's text is contained in a single IXMLDOMText object that is the child of the element. If there is markup inside an element, it is parsed into child elements that are siblings of the IXMLDOMText object(s). (Note that the content of the markup elements also appears within text nodes, which are the children of the specific markup element.)

When a document is first made available to the DOM, all text is normalized: there is only one text node for each block of text. Users can create adjacent text 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, so they will not persist between DOM sessions.

The normalize method on the IXMLDOMElement object merges adjacent text nodes into a single node. You should normalize before starting any operations that depend on a particular document structure, to ensure that subsequent sessions will operate on the same structure.

Interface Information

Implementation Msxml.dll
Inherits from IXMLDOMCharacterData
Header and IDL files Msxml.h, Xmldom.idl
Minimum availability Internet Explorer 5
Minimum operating systems Windows 95, Windows NT 4.0


Back to topBack to top

Did you find this topic useful? Suggestions for other topics? Write us!

© 1999 Microsoft Corporation. All rights reserved. Terms of use.