Xml.xmldom.IDOMNode.cloneNode

Delphi

function cloneNode(deep: WordBool): IDOMNode; safecall;

C++

virtual HRESULT __safecall cloneNode(System::WordBool deep, _di_IDOMNode &__cloneNode_result) = 0 ;

種類	可視性	ソース	ユニット	親
function	public	Xml.Xmldom.pas Xml.xmldom.hpp	Xml.xmldom	IDOMNode

説明

cloneNode メソッドはノードの複製を返します。

cloneNode メソッドを使用すると，ノードのコピーを取得できます。cloneNode メソッドは，親を持たないノードのコピーを返します。デフォルト値を表す属性ノードを含むすべての属性もコピーされます。

deep は，このノードの子ノードも複製するかどうかを示します。たとえば，要素ノードにテキストが入っている場合，cloneNode メソッドは deep が true のときにのみテキストをコピーします。この理由は，テキストが TEXT_NODE 型の子ノードに含まれているからです。

メモ： 要素ノードを複製するときに属性をコピーするのではなく，属性ノードを直接複製する場合，返されたノードの指定したプロパティは常に true です。このノードが指定した属性を表していない場合でも同じです。

メモ： 不変サブツリーの複製は可変性となりますが，エンティティ参照ノードの子は読み出し専用です。

メモ： DOM 実装では，DOCUMENT_NODE 型，DOCUMENT_TYPE_NODE 型，ENTITY_NODE 型，および NOTATION_NODE 型のノードの複製方法はそれぞれ異なります。