TDOMNode.ReplaceChild function

Declaration

function ReplaceChild(NewChild: TDOMNode; OldChild: TDOMNode): TDOMNode
 ; virtual

Arguments

Function result

Old child node replaced in the method.

Description

ReplaceChild is a TDOMNode function which specifies the method used to replace a child node in the DOM sub-tree with the specified DOM node. NewChild is the DOM node to store in the DOM sub-tree. OldChild is the existing DOM node replaced with the new node value.

While TDOMNode specifies the method, it does not provide physical storage for child nodes. As a result, ReplaceChild always raises an EDOMHierarchyRequest exception and the return value is always Nil. ReplaceChild must be re-implemented in a descendent class to provide the functionality required for other DOM node specializations.

See also

• TDOMNode
• TDOMNode_WithChildren
• TDOMDocument
• EDOMHierarchyRequest