Sign in Join
FPDoc Onlineexperiment

TDOMEntity.CloneNode function

Member of TDOMEntitypublicIn unit Laz2_DOM

Makes a copy of the DOM node with the specified owner document.

Declaration

pascal
function CloneNode(deep: Boolean; aCloneOwner: TDOMDocument): TDOMNode
 ; override

Arguments

deepTrue if child nodes are recursively copied in the method.
aCloneOwner

Document which owns the clones Entity node.

Function result

DOM node created in the method.

Description

CloneNode is an overridden TDOMNode function in TDOMEntity used to make a copy of the node with ACloneOwner as the owner document for the new node. It re-implements the method from the ancestor class.

CloneNode allocates a new TDOMEntity instance in the node pool for ACloneOwner, and creates the DOM Entity node in the return value. Values from the PublicID, SystemID, and NotationName properties are copied to the new node. The internal name for the Entity (set when the owner document was de-serialized) is also copied to the new node. When deep is True, the CloneChildren method is called to copy the ChildNodes (when assigned) to the new node.

CloneNode calls SetReadOnly to ensure that the new node cannot be modified. The cloned node does not have a parent node.

See also

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.