Эта функция возвращает набор выборки AutoCAD, отфильтрованный по указанному векторному слою и дополнительному подтипу из чертежа и, при необходимости, указанному набору выборки. Эта функция аналогична опции Объекты инструмента Выбрать объекты в контекстном меню векторного веб-слоя или векторного слоя документа на панели Ресурсы Esri.
Синтаксис
(esri_featurelayer_select flname subtype [select_settings])
Аргументы
- flname | string | обязательный | Имя существующего векторного веб-слоя или векторного слоя документа на чертеже.
- subtype | string | обязательный | Имя подтипа векторного слоя или пустая строка "" для всех подтипов или в случае, если нет подтипов.
- select_settings | связанный список | дополнительный | Список дополнительных настроек в виде пар значений, разделенных точкой, для ограничения выборки, установленной атрибутивным запросом и предварительным выбором.
Связанная надпись Тип значения Описание значения Обязательные или дополнительные "SSET" Объект набора выборки AutoCAD
Объект набора выборки AutoLISP . Функцию AutoCAD AutoLISP (ssget) можно использовать, чтобы предложить пользователю выбрать элементы для этой функции. Если набор выборки опущен, все объекты векторного слоя указанного подтипа будут включены в возвращенный набор выборки, как и все наборы выборки AutoCAD. Лучше всего освободить ресурсы, используемые всеми наборами выборки, после их использования. Вы можете сделать это, установив для наборов выборки значение nil после использования.
optional
"ATTRIBUTEQUERY" string
Условие where с одним именем поля для ограничения возвращаемого значения этого поля. Если также указано flname, имя поля, включенное в строку условия where, должно существовать в этом определении класса пространственных объектов.
optional
Пример использования 1
Попытайтесь создать набор выборки для всех объектов, принадлежащих векторному слою Shelters в текущем чертеже:(esri_featurelayer_select "Shelters" "")
Пример использования результата 1
Возвратится набор выборки всех объектов, принадлежащих к векторному слою Shelters:
<Selection set: 2e>
Пример использования 2
Попытайтесь создать набор выборки для всех объектов, принадлежащих подтипу 1 векторного слоя Shelters в текущем чертеже, для которых значения в поле capacity больше 400:(esri_featurelayer_select "Shelters" "1"
(list (cons "ATTRIBUTEQUERY" "capacity > 400"))
)
Пример использования результата 2
Возвращает набор выборки для всех объектов, принадлежащих подтипу 1 векторного слоя Shelters в текущем чертеже, для которых значения в поле capacity больше 400:
<Selection set: 30>
Возвращаемые значения
- В случае успеха возвращается объект набора выборки AutoCAD.
- В случае неудачи возвращается список с первым значением nil, а затем связанный список, содержащий значение ключа "Error" и соответствующее сообщение об ошибке в виде строки: (nil ( "Error" . "<message>"))
Не удалось возвратить значения
Неудачное возвращение значения может произойти по любой из следующих причин:
- (nil ("Error" . "Missing required argument."))
Не указан один или несколько обязательных аргументов.
- (nil ("Error" . "No feature layer specified."))
Обязательное значение векторного слоя недопустимо или отсутствует.
- (nil ("Error" . "Sublayer not found."))
Обязательное имя subtype не допустимо или отсутствует.