Добавляет в слой заданный элемент c присвоением ему заданного ID.
Visual Basic:
Function AddElementEx(Elem As Element, ElemID As Long, Flags As Long) As Long
Elem - добавляемый элемент
ElemID - ID добавляемого элемента
Flags - признак необходимости проверки на существование указанного ElemID ( 0 - не проверять, 1 - проверять).
Если значение ElemID равно -1, то записываемому элементу ID присваивается автоматически, аналогично методу AddElement.
При отсутствии проверки на существование в слое элемента с указанным ID метод работает быстрее, но в этом случае разработчик должен сам быть уверен, что повторение ключа исключается (например, последовательная запись в новый слой с увеличением значения очередного ElemID на единицу).
Если такой уверенности нет, то нужно задавать флаг проверки Flags равным 1. Тогда, есл ключ с указанным ElemID в слое уже существует, в добавлении нового элемента будет отказано.
Если добавление элемента выполнено успешно, метод возвращает ID добавленного элемента. В противном случае метод возвращает -1.