CreateXMLNode()

Синтаксис

*Result = CreateXMLNode(*ParentNode , Name$ [, *PreviousNode [, Type]])

Описание

Создает новый узел XML и вставляет его в данный родительский узел.

Параметры

*ParentNode	Узел, в который можно вставить новый узел. Здесь для вставки нового узла в корень дерева можно использовать функцию RootXMLNode().
Name$	Имя узла. Может быть пустой строкой, если имя для узла не требуется.
*PreviousNode (дополн.)	Задаёт дочерний узел узла '*ParentNode', после которого должен быть вставлен новый узел. Если это значение равно 0 или не указано, новый узел вставляется как первый дочерний узел своего родителя. Если это значение равно -1, узел вставляется как последний дочерний узел своего родителя.
Type (дополн.)	Задаёт Тип для нового узла. Значение по умолчанию - #PB_XML_Normal. Обратите внимание на то, что тип узла не может быть изменен, после того как узел уже создан.

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

Возвращает указатель на новый узел XML, если он был успешно создан, если же узел в это место вставить не удалось, возвратится ноль.

Комментарии

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

См. также

DeleteXMLNode()

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

Все