Share via

splitText Method

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/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.