MoveXMLNode()

Syntax

Ergebnis = MoveXMLNode(*Knoten, *ElternKnoten [, *VorherigerKnoten])

Verschiebt den angegebenen XML-Knoten und all seinen beinhalteten Text und "Kinder" (children) an eine neue Stelle.
Diese Funktion kann auch verwendet werden, um Knoten in einen anderen XML-Baum zu verschieben. Für das Kopieren eines kompletten Knotens an eine neue Stelle kann CopyXMLNode() verwendet werden.

Parameter

*Knoten	Der zu verschiebende Knoten.
*ElternKnoten	(englisch "ParentNode"). Der Knoten, in welchen der neue Knoten eingefügt werden soll. Um den neuen Knoten als Wurzel des Baums einzufügen, kann hier RootXMLNode() verwendet werden.
*VorherigerKnoten (optional)	(englisch "PreviousNode"). Ein untergeordneter Knoten (englisch "childnode") von '*ElternKnoten', nach welchem der neue Knoten eingefügt werden soll. Wenn dieser Wert 0 ist oder der Parameter nicht angegeben wird, dann wird der neue Knoten als erstes "Kind" (child) seiner "Eltern" eingefügt. Wenn der Wert gleich -1 ist, dann wird der neue Knoten als letztes "Kind" (child) seiner "Eltern" eingefügt.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn das Verschieben erfolgreich war - oder Null, wenn der Knoten nicht verschoben werden konnte.

Anmerkungen

Die folgenden Regeln müssen für ein erfolgreiches Verschieben eingehalten werden:
- Der Wurzel-Knoten eines Baums kann nicht verschoben werden
- '*ElternKnoten' darf nicht vom Typ #PB_XML_Comment oder #PB_XML_CData sein
- '*VorherigerKnoten' muss ein direktes "Kind" (child) von '*ElternKnoten' sein (wenn dieser spezifiziert wurde)
- '*Knoten' und '*VorherigerKnoten' können nicht gleich sein
- '*ElternKnoten' kann ebenfalls nicht gleich sein, oder ein "Kind" (child) von '*Knoten' (ein Knoten nicht in sich selbst verschoben werden)
- Wenn der XML-Baum bereits einen Hauptknoten hat, können auf der Wurzel-Ebene nur andere Knoten als #PB_XML_Normal und #PB_XML_CData eingefügt werden

Siehe auch

DeleteXMLNode(), CopyXMLNode()

Unterstützte OS

Alle