All Frameworks Class Hierarchy This Framework Previous Next Indexes
System.IUnknown | +---System.IDispatch | +---System.CATBaseUnknown | +---XMLParser.CATIDOMNode | +---XMLParser.CATIDOMCharacterData | +---CATIDOMText
Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.
interface CATIDOMText
Interface representing the textual content (termed character data in XML) of a
CATIDOMElement
or CATIDOMAttr
.
This interface inherits from CATIDOMCharacterData. If there is no markup inside an element's content, the text is contained in a single object
implementing the
CATIDOMText interface that is the only child of the element. If there is markup, it is parsed into the information items
(elements, comments, etc.) and
CATIDOMText nodes that form the list of children of the element.
When a document is first made available via the DOM, there is only one
CATIDOMText node for each block of text. Users may create adjacent
CATIDOMText 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. The
CATIDOMNode.Normalize method merges any such adjacent
CATIDOMText objects into a single node for each block of text ; this is recommended before employing operations that depend on a
particular document structure, such as navigation with
XPointers.
iOffset
,
keeping both in the tree as siblings.
public virtual HRESULT SplitText( | unsigned int | iOffSet, |
CATIDOMText_var& | oText) = 0 |
iOffset
,
keeping both in the tree as siblings.
After being split, this node will contain all the content up
to the iOffset
point.
A new node of the same type, which contains all the content at and
after the iOffset
point, is returned. If the original
node had a parent node, the new node is inserted as the next sibling
of the original node. When the iOffset
is equal to the
length of this node, the new node has no data.
0
.
Error Class | Error Id | Description |
---|---|---|
CATDOMException | XMLParserERR_2201 | INDEX_SIZE_ERR: Raised if the specified iOffset is greater
than the number of characters in data . |
CATDOMException | XMLParserERR_2207 | NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. |
Copyright © 2003, Dassault Systèmes. All rights reserved.