IDOMText::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.

Syntax

HRESULT splitText(
    long offset,
    IDOMText ** 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.

Return Value

Returns S_OK if successful, or an error code otherwise.

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.