CreateXMLNode()
Syntax
*Ergebnis = CreateXMLNode(*ElternKnoten [, *VorherigerKnoten [, Typ]])Beschreibung
Erstellt einen neuen XML-Knoten und fügt diesen in den angegebenen Elternknoten ein.
Parameter
'*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.
'Typ' definiert den Typ des neuen Knotens. Der Standard ist #PB_XML_Normal. Beachten Sie, dass der Knoten-Typ nicht mehr geändert werden kann, nachdem der Knoten erstellt wurde.
Die folgenden Regeln müssen für ein erfolgreiches Einfügen eingehalten 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)
- Ein Knoten vom Typ #PB_XML_Root kann nicht manuell erstellt 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
Rückgabewert
Gibt den Zeiger auf den neuen XML-Knoten zurück, wenn dieser erfolgreich erstellt wurde - oder 0, wenn an dieser Stelle kein Knoten eingefügt werden konnte.
Unterstützte OS
Alle