splitText Method (Windows Embedded CE 6.0)

1/6/2010

Splits 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.

Script Syntax

var objXMLDOMText = oXMLDOMText.splitText(offset);

Remarks

Script Parameters

• offset
  Long integer. Number of characters at which to split this text node into two nodes, starting from zero.

Script Return Value

Object. Returns the new text node.

C/C++ Syntax

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

Remarks

C/C++ Parameters

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

• rightHandTextNode
  [out, retval] 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.

Requirements

Header	msxml2.h, msxml2.idl
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.0 and later

General 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.

This method applies to the following objects and interfaces:

IXMLDOMCDATASection and IXMLDOMText.

See Also

Reference

XML DOM Methods