cloneNode Method (Windows Embedded CE 6.0)

1/6/2010

Clones a new node.

Script Syntax

var objXMLDOMNode = oXMLDOMNode.cloneNode(deep);

Remarks

Script Parameters

• deep
  Boolean. Flag that indicates whether to recursively clone all nodes that are descendants of this node. If True, create a clone of the complete tree below this node. If False, clone this node and its attributes only.

Script Return Value

Object. Returns the newly created clone node.

C/C++ Syntax

HRESULT cloneNode(
  VARIANT_BOOL deep,
  IXMLDOMNode** cloneRoot
);

Remarks

C/C++ Parameters

• deep
  [in] Flag that indicates whether to recursively clone all nodes that are descendants of this node. If True, create a clone of the complete tree below this node. If False, clone this node and its attributes only.

• cloneRoot
  [out, retval] Newly created clone node.

C/C++ Return Values

• S_OK
  Value returned if successful.

• E_INVALIDARG
  Value returned if cloneRoot is Null.

Requirements

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

General Remarks

The cloned node has the same property values as this node for the following properties: nodeName Property, nodeValue, nodeType, parentNode, ownerDocument, and, if it is an element, attributes. The value of the clone's childNodes depends on the setting of the deep flag parameter.

Note

If the node is the DOMDocument node, it is safer to clone the document using the save method, as follows. doc.save(doc2);

This method applies to the following objects and interfaces:

IXMLDOMAttribute, IXMLDOMCDATASection, IXMLDOMCharacterData, IXMLDOMComment, DOMDocument, IXMLDOMDocumentFragment, IXMLDOMDocumentType, IXMLDOMElement, IXMLDOMEntity, IXMLDOMEntityReference, IXMLDOMNode, IXMLDOMNotation, IXMLDOMProcessingInstruction, IXMLDOMText, and IXTLRuntime.

See Also

Reference

XML DOM Methods

Concepts

nodeValue Property
nodeType Property
parentNode Property
ownerDocument Property
attributes Property
childNodes Property

Other Resources