RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
IDOMNode.replaceChild Method

Replaces one of this node's children with a specified node.

Pascal
function replaceChild(const newChild: IDOMNode; const oldChild: IDOMNode): IDOMNode; safecall;
C++
__fastcall IDOMNode replaceChild(const IDOMNode newChild, const IDOMNode oldChild);

Use replaceChild to remove a child of this node and replace it with the node specified by newChild. 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, refChild is a node that is not in this node's child list, newChild was created using a different document, or if newChild is of a nodeType that is not permitted as a child of this node, replaceChild raises an exception. 

newChild is the child node that replaces oldChild. 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. 

refChild is a child that newChild replaces. If refChild is nil (Delphi) or NULL (C++), the new node is added to the end of this node's child list. 

replaceChild returns the interface for refChild (the replaced node). 

 

AppendChild 

ChildNodes 

replaceChild 

insertBefore

Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
What do you think about this topic? Send feedback!