RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
IDOMNode.appendChild Method

Adds a new child node to this node.

Pascal
function appendChild(const newChild: IDOMNode): IDOMNode; safecall;
C++
__fastcall IDOMNode appendChild(const IDOMNode newChild);

Use appendChild to add a child node to the end of this node's list of children. If the new node is already in the document's node hierarchy, it is first removed from its parent node. If this node is read-only, newChild was created using a different document, or if newChild is of a nodeType that is not permitted as a child of this node, appendChild raises an exception. 

newChild is the child node to add. It can be a node that currently has another parent node, or a new node created using the methods of the document interface. If it is of nodeType DOCUMENT_FRAGMENT_NODE, the entire contents of the document fragment are moved into this node's childNodes property list. 

appendChild returns the interface for the newly added child node. 

 

Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!