XMLParserItf Interface 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 . If there is no markup inside an element's content, the text is contained in a single object implementing the interface that is the only child of the element. If there is markup, it is parsed into the information items (elements, comments, etc.) and nodes that form the list of children of the element.

When a document is first made available via the DOM, there is only one node for each block of text. Users may create adjacent 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 method merges any such adjacent 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.

See also:
, ,


Method Index


o SplitText(unsigned int,CATIDOMText_var&)
Breaks this node into two nodes at the specified iOffset, keeping both in the tree as siblings.

Methods


o SplitText
public virtual SplitText( iOffSet,
oText)
Breaks this node into two nodes at the specified 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.
Parameters:
iOffSet
The characters offset at which to split, starting from 0.
oText
The new node, of the same type as this node.
Errors Returned:
Error Class Error Id Description
XMLParserERR_2201 INDEX_SIZE_ERR: Raised if the specified iOffset is greater than the number of characters in data.
XMLParserERR_2207 NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

This object is included in the file: CATIDOMText.h
If needed, your Imakefile.mk should include the module: CatXmlItfExt

Copyright © 1999-2014, Dassault Systèmes. All rights reserved.