IXMLDOMText::splitText Method

---

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.

Visual Basic Syntax

Set objXMLDOMText = oXMLDOMText.splitText(offset)

C/C++ Syntax

HRESULT splitText(
    long offset,
    IXMLDOMText **rightHandTextNode);

Parameters

offset

[in] Number of characters at which to split this text node into two nodes, starting from zero.

rightHandTextNode

[out] New text node.

C/C++ Return Values

S_OK

Value returned if successful.

S_FALSE

Value when returning null. 

E_FAIL

Value returned if an error occurs.

Remarks

If you specify an offset of zero, the first text node is empty and the right-hand text node contains the previous contents of the node.

If you specify an offset beyond the end of the string, a new, empty right-hand text node is created.