Xml.xmldom.IDOMNode.replaceChild
Delphi
function replaceChild(const newChild, oldChild: IDOMNode): IDOMNode; safecall;
C++
virtual HRESULT __safecall replaceChild(const _di_IDOMNode newChild, const _di_IDOMNode oldChild, _di_IDOMNode &__replaceChild_result) = 0 ;
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | Xml.Xmldom.pas Xml.xmldom.hpp |
Xml.xmldom | IDOMNode |
説明
ノードの子のいずれかと,指定したノードを置き換えます。
replaceChild メソッドを使用すると,ノードの子を削除し,newChild によって指定されたノードと置き換えることができます。新しいノードがすでにドキュメントのノード階層に入っている場合,そのノードはまず親ノードから削除されます。
このノードが読み出し専用の場合,refChild がこのノードの子ノードリストにないノードの場合,newChild が別のドキュメントを使って作成された場合,または newChild がこのノードの子として許可されていない nodeType の場合,replaceChild メソッドは例外を生成します。
newChild は oldChild と置き換える子ノードです。別の親ノードを持つノードでも,ドキュメントインターフェースのメソッドを使って作成された新しいノードでもかまいません。ノードの nodeType プロパティが DOCUMENT_FRAGMENT_NODE の場合,ドキュメントフラグメントの内容全体がこのノードの childNodes プロパティリストに移動されます。
oldChild は newChild が置き換える子ノードです。refChild が nil(Delphi)または NULL(C++)の場合,新しいノードがこのノードの子ノードリストの末尾に追加されます。
replaceChild メソッドは,oldChild(置き換えられたノード)のインターフェースを返します。