Добавляет определение векторного слоя документа к чертежу AutoCAD.
Использование:
- Если FEATURE_LAYER_PROPERTIES не указан, класс объектов будет создан без фильтра запроса, а для GEOMTYPE будет установлено значение Point (Точка).
- Если включен дополнительный параметр LAYERFILTER, список слоев используется как QUERYFILTER.
- Если требуется более сложный фильтр запроса, чем включающий список слоев, воспользуйтесь отдельной функцией esri_docfeaturelayer_setquery.
- Если имя нового векторного слоя уже существует, то добавляется указанное имя, но с добавлением номера в конце
Синтаксис
(esri_docfeaturelayer_add flname [featurelayer_properties])
Аргументы
- flname | string | обязательный | имя нового векторного слоя документа.
- featurelayer_properties | связанный список | дополнительный | Свойства векторного слоя.
Связанная надпись Тип значения Описание значения Обязательные или дополнительные "GEOMTYPE " String
Тип геометрии нового векторного слоя: {"Polygon", "Point", "Polyline", "Annotation" или "Multipatch"}
дополнительно (по умолчанию Point.)
"LAYERFILTER" String
Одно или несколько имен слоев AutoCAD, разделенных запятыми, в виде одной строки, для определения QUERYFILTER нового класса объектов.
Примечание:
- По умолчанию – это значение "*", что соответствует всем слоям.
- Используйте функцию esri_docfeaturelayer_setquery для создания сложного QUERYFILTER.
дополнительный
Пример использования
Попытайтесь добавить полилинейный объект документа с именем ROADS, в котором объекты, определяющие векторный слой, находятся в слое AutoCAD STREETS:(esri_docfeaturelayer_add "ROADS"
(list
(cons "GEOMTYPE" "POLYLINE")
(cons "LAYERFILTER" "STREETS")
))
Пример использования результата
Попытайтесь добавить полилинейный объект документа с именем ROADS, в котором объекты, определяющие векторный слой AutoCAD STREETS, находятся в слое, и возвращает список, содержащий имя нового векторного слоя:
("ROADS")
Возвращаемые значения
- В случае успеха возвращается список, содержащий имя нового векторного слоя документа.
- В случае неудачи возвращается список с первым значением nil, а затем связанный список, содержащий значение ключа "Error" и соответствующее сообщение об ошибке в виде строки: (nil ("Error" . "<message>"))
Не удалось возвратить значения
Неудачное возвращение значения может произойти по любой из следующих причин:
- (nil ("Error" . "Missing required argument."))
Не указан один или несколько обязательных аргументов.
См. также
(esri_webfeaturelayer_add) | Добавляет новый векторный веб-слой.
(esri_weblayer_add) | Добавляет новый веб-слой: слой изображений, слой изображений карты или векторный веб-слой.
(esri_docfeaturelayer_setquery) | Задает запрос фильтра векторного слоя документа.