La función esri_featurelayer_select devuelve un conjunto de selección de AutoCAD filtrado por la capa de entidades especificada y el subtipo opcional del dibujo y, opcionalmente, el conjunto de selección especificado. Esta función es similar a la opción Objetos de la herramienta Seleccionar entidades en el menú contextual de una capa de entidades web o una capa de entidades de documento en el panel Contenido.
Sintaxis
(esri_featurelayer_select flname subtype [select_settings])
Argumentos
- flname | cadena de caracteres | obligatorio | Un nombre de una capa de entidades web existente o un nombre de capa de entidades de documentos en el dibujo.
- subtype | cadena de caracteres | obligatorio | Nombre de subtipo de la capa de entidades o cadena de caracteres vacía "" para todos los subtipos o si no hay subtipos.
- select_settings | lista asociada | opcional | Lista de ajustes opcionales como pares de puntos punto para limitar el conjunto de selección por consulta de atributos y preselección.
Etiqueta asociada Tipo de valor Descripción del valor Obligatorio u opcional "SSET" Objeto del conjunto de selección de AutoCAD
Un objeto del conjunto de selección de AutoLISP. La función (ssget) de AutoLISP de AutoCAD se puede utilizar para solicitar al usuario que seleccione entidades para esta función. Si no se proporciona ningún conjunto de selección, todas las entidades de la capa de entidades del subtipo especificado se incluirán en el conjunto de selección devuelto, al igual que todos los conjuntos de selección de AutoCAD. Se recomienda publicar los recursos utilizados por todos los conjuntos de selección después de utilizarlos. Para esto, establezca los conjuntos de selección en nil después de su uso.
Opcional
"ATTRIBUTEQUERY" cadena
Una cláusula where que utiliza un nombre de campo único para limitar el valor devuelto a este único campo. Si también se proporciona el valor flname, el nombre de campo incluido en la cadena de caracteres de la cláusula where debe existir en esa definición de clase de entidad.
Opcional
Nota:
No se recomienda intentar administrar un gran número de conjuntos de selección al mismo tiempo. La aplicación no puede tener más de 128 conjuntos de selección abiertos a la vez. (El límite podría ser más bajo en su sistema). Cuando se alcance el límite, AutoCAD no creará más conjuntos de selección. Mantenga un número mínimo de conjuntos abierto al mismo tiempo y configure los conjuntos de selección innecesarios en nil lo antes posible. Si se alcanza el número máximo de conjuntos de selección, no es posible crear más.
Ejemplo de uso 1
En este ejemplo se crea un conjunto de selección de todas las entidades que pertenecen a la capa de entidades Shelters en el dibujo actual:(esri_featurelayer_select "Shelters" "")
Ejemplo de resultado de uso 1
Se devuelve un conjunto de selección de todas las entidades que pertenecen a la capa de entidades Shelters:
<Selection set: 2e>Ejemplo de uso 2
En este ejemplo se crea un conjunto de selección de todas las entidades que pertenecen al subtipo 1 de la capa de entidades Shelters del dibujo actual donde los valores de campo capacity son superiores a 400:(esri_featurelayer_select "Shelters" "1"
(list (cons "ATTRIBUTEQUERY" "capacity > 400"))
)
Ejemplo de resultado de uso 2
Se devuelve un conjunto de selección de todas las entidades que pertenecen al subtipo 1 de la capa de entidades Shelters del dibujo actual cuando los valores de campo capacity son superiores a 400:
<Selection set: 30>Valores de retorno
Los siguientes son los valores de retorno posibles:
- Si todo va bien, devuelve un objeto de conjunto de selección de AutoCAD.
- Si se produce un error, devuelve una lista con el primer valor de nil y, a continuación, se devuelve una lista asociada que contiene el valor de clave "Error" y un mensaje de error asociado como cadena de caracteres: (nil ( "Error" . "<message>")).
Valores de retorno fallido
Se puede producir un valor de retorno fallido por cualquiera de los siguientes motivos:
- (nil ("Error" . "Missing required argument."))
No se suministraron uno o más de los argumentos requeridos.
- (nil ("Error" . "Feature layer not found."))
El valor de la capa de entidades requerido no es válido o falta.
- (nil ("Error" . "Sublayer not found."))
El nombre subtype requerido no es válido o falta.