All Frameworks  Class Hierarchy  This Framework  Previous  Next  Indexes

XMLParser Interface CATIDOMText

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.

See also:
CATIDOMCharacterData, CATIDOMElement, CATIDOMAttr


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 HRESULT SplitText(unsigned int iOffSet,
CATIDOMText_var& oText) = 0
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
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.

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

Copyright © 2003, Dassault Systèmes. All rights reserved.