Xml.xmldom.IDOMNode.insertBefore
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 ;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Xml.Xmldom.pas Xml.xmldom.hpp |
Xml.xmldom | IDOMNode |
Description
Insère un nouveau noeud enfant avant l'enfant spécifié du noeud.
Utilisez insertBefore pour ajouter un noeud enfant à une position spécifiée dans la liste des enfants de ce noeud. Si le nouveau noeud est déjà présent dans la hiérarchie des noeuds du document, il est tout d'abord retiré de son noeud parent. Si ce noeud est en lecture seule, refChild est un noeud n'appartenant pas à la liste des enfants du noeud, newChild a été créé en utilisant un autre document ou bien, si newChild est d'un type de noeud non autorisé en tant qu'enfant de ce noeud, insertBefore déclenche une exception.
newChild est le noeud enfant à ajouter. Il peut s'agir d'un noeud ayant actuellement un autre noeud parent ou d'un nouveau noeud créé par le biais des méthodes de l'interface du document. Il est du type DOCUMENT_FRAGMENT_NODE. Le contenu entier du fragment de document est transféré dans la liste des propriétés childNodes de ce noeud.
refChild est un enfant de ce noeud devant lequel le nouveau noeud est inséré. Si la valeur de refChild est égale à nil (Delphi) ou NULL (C++), le nouveau noeud est ajouté à la fin de la liste des enfants de ce noeud.
insertBefore renvoie l'interface du noeud enfant nouvellement ajouté.