Xml.xmldom.IDOMNode.insertBefore

Übergeordnet: IDOMNode

Delphi

function insertBefore(const newChild, refChild: IDOMNode): IDOMNode; safecall;

C++

virtual HRESULT __safecall insertBefore(const _di_IDOMNode newChild, const _di_IDOMNode refChild, _di_IDOMNode &__insertBefore_result) = 0 ;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	Xml.Xmldom.pas Xml.xmldom.hpp	Xml.xmldom	IDOMNode

Beschreibung

Fügt vor dem angegebenen untergeordneten Knoten einen neuen untergeordneten Knoten in diesen Knoten ein.

Verwenden Sie insertBefore, um an der angegebenen Position einen untergeordneten Knoten in die Liste der untergeordneten Knoten dieses Knotens einzufügen. Befindet sich der neue Knoten bereits in der Hierarchie des Dokumentknotens, wird er zunächst aus der Hierarchie seines übergeordneten Knotens entfernt. Ist dieser Knoten schreibgeschützt, ist refChild ein Knoten, der sich nicht in der Liste untergeordneter Knoten dieses Knotens befindet, wurde newChild unter Verwendung eines anderen Dokuments erstellt oder weist newChild in seiner Eigenschaft nodeType einen Wert auf, der für untergeordnete Knoten dieses Knotens nicht zulässig ist, löst insertBefore eine Exception aus.

newChild ist der hinzuzufügende untergeordnete Knoten. Es kann sich um einen Knoten handeln, der derzeit einen anderen übergeordneten Knoten aufweist, oder um einen neuen Knoten, der mit den Methoden der Dokumentschnittstelle erstellt wurde. Weist der Knoten in der Eigenschaft nodeType den Wert DOCUMENT_FRAGMENT_NODE auf, wird der gesamte Inhalt des Dokumentfragments in die Eigenschaftsliste childNodes dieses Knotens verschoben.

refChild ist der untergeordnete Knoten dieses Knotens, vor dem der neue Knoten eingefügt werden soll. Hat refChild den Wert nil (Delphi) bzw. NULL (C++), wird der neue Knoten am Ende der Liste untergeordneter Knoten hinzugefügt.

insertBefore gibt die Schnittstelle für den neu hinzugefügten untergeordneten Knoten zurück.