Функция esri_featurelayer_selectspecial возвращает набор выборки AutoCAD из указанного векторного слоя на основе специальных критериев. Эта функция применяется для обеспечения качества и проверки соответствия перед синхронизацией векторных веб-слоев или для поиска объектов на основе различных состояний редактирования и данных при работе с векторными слоями.
К специальным критериям поиска относятся следующие:
- FlaggedAsModified — элементы AutoCAD, которые квалифицируются как объекты указанного векторного веб-слоя и статус редактирования которых отмечен как измененные.
- FlaggedAsNew — элементы AutoCAD, которые квалифицируются как объекты указанного векторного веб-слоя и состояние редактирования которых помечено как новый объект.
- IncorrectGeometry — элементы AutoCAD, которые можно квалифицировать как объекты благодаря слою AutoCAD, в котором они находятся, но которые не считаются объектами, поскольку имеют неправильный тип геометрии. Примером являются полилинии, нарисованные на слое AutoCAD точечных объектов ArcGIS.
- OutsideProjectArea — элементы AutoCAD, которые квалифицируются как объекты указанного векторного слоя и находятся за пределами текущей границы области проекта.
- ProxyObjectPresent — вспомогательные элементы AutoCAD, используемые для представления пользовательской геометрии объекта, такие как точки COGO за пределами AutoCAD Civil 3D, или когда признак объекта отсутствует.
- UnclosedPolylines — полилинейные элементы AutoCAD, которые можно квалифицировать как полигональные объекты, но для которых не задан флаг замкнутости полилиний.
Примечание:
Не рекомендуется пытаться управлять большим количеством наборов выборки одновременно. В приложении не может одновременно быть открыто более 128 наборов выборки. (В вашей системе этот предел может быть ниже.) При достижении предела дополнительные наборы выборки создаваться не будут AutoCAD. Одновременно открывайте минимальное количество наборов и устанавливайте ненужные наборы выборки на nil как можно скорее. Если будет достигнуто максимальное количество наборов выборки, вы не сможете создать больше.
Синтаксис
(esri_featurelayer_selectspecial flname select_settings)
Аргументы
- flname | string | обязательный | Имя существующего векторного веб-слоя или векторного слоя документа на чертеже.
- select_settings | связанный список | обязательный | связанный список выбранных настроек.
| Связанная надпись | Тип значения | Описание значения | Обязательные или дополнительные |
|---|---|---|---|
| "CRITERIA" | string | Критерий поиска. Корректные значения: "UnclosedPolyline" и "IncorrectGeometry", "ProxyObjectPresent". Для векторного веб-слоя возможны только варианты "FlaggedAsModified" , "FlaggedAsNew" и "OutsideProjectArea". | Обязательный |
| "SUBTYPE" | string | Имя подтипа в виде строки. Чтобы включить все подтипы, используйте пустую строку "". | Дополнительный |
Пример использования 1
Создайте набор выборки для всех элементов, принадлежащих векторному слою shelters вне области проекта текущего чертежа:(esri_featurelayer_selectspecial "shelters"
(list (cons "CRITERIA" "OutsideProjectArea"))
)
Пример использования результата 1
Набор выборки для всех элементов, принадлежащих векторному слою shelters вне области проекта текущего чертежа:
<Selection set: 9f>Пример использования 2
Создайте набор выборки всех объектов, принадлежащих подтипу Public векторного веб-слоя Roads, которые ArcGIS for AutoCAD считает измененными перед синхронизацией в текущем чертеже:(esri_featurelayer_selectspecial "Roads"
(list (cons "CRITERIA" "FlaggedAsModified")(cons "Subtype" "Public"))
)
Пример использования результата 2
Возвращает набор выборки всех элементов, принадлежащих подтипу Public векторного веб-слоя Roads, которые ArcGIS for AutoCAD считает измененными перед синхронизацией в текущем чертеже:
<Selection set: d0>Возвращаемые значения
Ниже перечислены возможные возвращаемые значения:
- В случае успеха возвращается объект набора выборки AutoCAD.
- В случае неудачи возвращает список с первым значением nil, а затем связанный список, содержащий значение ключа "Error" и соответствующее сообщение об ошибке в виде строки: (nil ("Error" . "<message>")).
Не удалось возвратить значения
Неудачное возвращение значения может произойти по любой из следующих причин:
- (nil ("Error" . "Missing required argument."))
Не указан один или несколько обязательных аргументов.
- (nil ("Error" . "Feature layer not found."))
Обязательное значение векторного слоя недопустимо или отсутствует.
- (nil ("Error" . "Subtype name does not exist."))
Обязательное имя subtype не допустимо или отсутствует.