CopyXMLNode()

Syntax

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

Kopiert den angegebenen XML-Knoten '*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' spezifiert den zu kopierenden Knoten.
'*ElternKnoten' (englisch "ParentNode") ist 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' (englisch "PreviousNode") definiert einen untergeordneten 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.

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 spezifiert 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

Rückgabewert

Gibt den Zeiger auf den neuen XML-Knoten zurück, wenn dieser erfolgreich kopiert wurde - oder 0, wenn das Kopieren nicht möglich war.

Unterstützte OS

Alle