CopyXMLNode()

Syntax

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

Kopiert 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 kopieren. Für das Verschieben eines kompletten Knotens an eine neue Stelle kann MoveXMLNode() verwendet werden.

Parameter

*Knoten	Der zu kopierende 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

Der Zeiger auf den neuen XML-Knoten, wenn dieser erfolgreich kopiert wurde - oder Null, wenn das Kopieren nicht möglich war.

Anmerkungen

Die folgenden Regeln müssen für ein erfolgreiches Kopieren eingehalten werden:
- Der Wurzel-Knoten eines Baums kann nicht kopiert 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)
- 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(), MoveXMLNode()

Unterstützte OS

Alle