MoveXMLNode()

Синтаксис

Result = MoveXMLNode(*Node , *ParentNode [, *PreviousNode])

Описание

Перемещает данный XML узел со всем содержащимся текстом и потомками в новое местоположение. Эта функция используется для перемещения узла в другое XML дерево. Для копирования полного узла в новое местоположение можно использовать функцию CopyXMLNode().

Параметры

*Node	Узел, который необходимо переместить.
*ParentNode	Узел, в который можно вставить перемещённый узел. Здесь для вставки нового узла в корень дерева можно использовать функцию RootXMLNode().
*PreviousNode (дополн.)	Задаёт дочерний узел узла '*ParentNode', после которого должен быть вставлен новый узел. Если это значение равно 0 или не указано, новый узел вставляется как первый дочерний узел своего родителя. Если это значение равно -1, узел вставляется как последний дочерний узел своего родителя.

Возвращаемое значение

Возвращает не нулевое значение, если перемещение было успешно или нуль, если узел переместить не удалось.

Комментарии

Для успешного перемещения должны выполняться следующие правила:
- Корневой узел дерева не может быть перемещен
- *ParentNode не может иметь тип #PB_XML_Comment или #PB_XML_CData
- *PreviousNode должен быть непосредственным потомком узла *ParentNode (если задано),
- Узлы *Node и *PreviousNode не могут быть равны
- узел *ParentNode не может быть равен узлу *Node или быть его дочерним узлом (узел невозможно переместить в самого себя)
- Если у дерева XML уже есть основной узел, то на корневом уровне можно вставлять только узлы, тип которых не #PB_XML_Normal и не #PB_XML_CData

См. также

DeleteXMLNode(), CopyXMLNode()

Поддерживаемые OS

Все