MoveXMLNode()

Syntaxe

Resultat = MoveXMLNode(*Noeud, *NoeudParent [, *NoeudPrecedent])

Déplace le '*Noeud' XML spécifié et tout son contenu (texte et noeuds fils) à un nouvel emplacement. Cette fonction peut même déplacer des noeuds de documents XML différents. Pour copier un noeud à un nouvel emplacement, utiliser CopyXMLNode().

Arguments

'*Noeud' indique le noeud à déplacer.
'*NoeudParent' est le noeud sous lequel le noeud déplacé sera inséré. Pour insérer le noeud à la racine de l'objet XML, utiliser RootXMLNode().
'*NoeudPrecedent' représente le noeud fils de '*NoeudParent' après lequel le nouveau noeud devra être inséré. Si sa valeur est omise ou égale à 0, le nouveau noeud est inséré en tant que premier fils du noeud parent. Si sa valeur est -1, alors le nouveau noeud est inséré comme dernier fils du noeud parent.

Les règles suivantes doivent être respectées pour que le déplacement se déroule correctement:
- Le noeud racine ne peut pas être déplacé
- '*NoeudParent' ne peut pas être de type #PB_XML_Comment ou #PB_XML_CData
- '*NoeudPrecedent' doit être un fils direct du '*NoeudParent' (s'il est spécifié)
- '*Noeud' et '*NoeudPrecedent' ne peuvent pas être identiques
- '*NoeudParent' ne peut pas être égal à '*Noeud'ou à un de ses fils (un noeud ne peut pas être déplacé dans lui-même)
- Si l'objet XML a déjà un noeud principal, seuls les noeuds de type autres que #PB_XML_Normal et #PB_XML_CData peuvent être insérés à la racine

Valeur de retour

Renvoie une valeur différente de zéro si le déplacement est un succès, ou zéro si le déplacement est impossible.

OS Supportés

Tous