La fonction esri_featurelayer_select renvoie un ensemble de sélection AutoCAD filtré selon la couche d’entités spécifiée et un sous-type facultatif du dessin, et éventuellement l’ensemble de sélection spécifié. Cette fonction est similaire à l’option Objects (Objets) de l’outil Sélectionner des entités du menu contextuel d’une couche d’entités Web ou de document dans la fenêtre Contents (Contenu).
Syntaxe
(esri_featurelayer_select flname subtype [select_settings])
Arguments
- flname | (chaîne) | (obligatoire) | Nom d’une couche d’entités Web ou de document qui existe dans le dessin.
- subtype | chaîne | obligatoire | Nom du sous-type de la couche d’entités ou chaîne vide ("") pour tous les sous-types ou s’il n’existe aucun sous-type.
- select_settings | liste associée | facultatif | Liste des paramètres facultatifs sous forme de paires pointées pour limiter l’ensemble de sélection par requête attributaire et présélection.
Etiquette associée Type de valeur Description de la valeur Requis ou facultatif "SSET" Objet d’ensemble de sélection AutoCAD
Un objet d’ensemble de sélection AutoLISP. La fonction AutoLISP AutoCAD (ssget) peut être utilisée pour inviter l’utilisateur à sélectionner des entités pour cette fonction. Si aucun ensemble de sélection n’est indiqué, toutes les entités de la couche d’entités du sous-type spécifié sont incluses dans l’ensemble de sélection renvoyé, comme tous les ensembles de sélection AutoCAD. Il est recommandé de libérer les ressources utilisées par la totalité des ensembles de sélection après les avoir utilisées. Pour ce faire, définissez les ensembles de sélection sur nil après les avoir utilisés.
Facultatif
"ATTRIBUTEQUERY" chaîne
Une clause Where utilisant un nom de champ unique pour limiter la valeur renvoyée à ce seul champ. Si la valeur flname est également spécifiée, le nom du champ inclus dans la chaîne de clause Where doit exister dans la définition de cette classe d’entités.
Facultatif
Remarque :
Il n’est pas recommandé d’essayer de gérer simultanément un nombre élevé d’ensembles de sélection. Une application ne peut pas comporter plus de 128 ensembles de sélection ouverts en même temps. (La limite peut être inférieure sur votre système.) Une fois la limite atteinte, AutoCAD ne crée plus d’ensembles de sélection. Gardez un nombre minimal d’ensembles ouverts simultanément et définissez les ensembles de sélection inutiles sur nil dès que possible. Si le nombre maximal d’ensembles de sélection est atteint, vous ne pouvez pas en créer davantage.
Exemple d’utilisation 1
Cet exemple crée un ensemble de sélection de toutes les entités qui appartiennent à la couche d’entités Shelters dans le dessin actuel :(esri_featurelayer_select "Shelters" "")
Exemple d’utilisation du résultat 1
Un ensemble de sélection de toutes les entités qui appartiennent à la couche d’entités Shelters est renvoyé :
<Selection set: 2e>Exemple d’utilisation 2
Cet exemple crée un ensemble de sélection de toutes les entités qui appartiennent au sous-type 1 de la couche d’entités Shelters dans le dessin actuel lorsque les valeurs du champ capacity sont supérieures à 400 :(esri_featurelayer_select "Shelters" "1"
(list (cons "ATTRIBUTEQUERY" "capacity > 400"))
)
Exemple d’utilisation du résultat 2
Renvoie un ensemble de sélection de toutes les entités qui appartiennent au sous-type 1 de la couche d’entités Shelters dans le dessin actuel lorsque les valeurs du champ capacity sont supérieures à 400 :
<Selection set: 30>Valeurs renvoyées
Voici les valeurs de renvoi possibles :
- En cas de réussite, renvoie un objet d’ensemble de sélection AutoCAD.
- En cas d’échec, renvoie une liste dont la première valeur est nil, puis une liste associée contenant la valeur de clé "Error" et un message d’erreur associé sous forme de chaîne : (nil ( "Error" . "<message>"))
Valeurs d’échec renvoyées
Un échec peut être dû par exemple aux raisons suivantes :
- (nil ("Error" . "Missing required argument."))
Un ou plusieurs des arguments requis n’a pas été fourni.
- (nil ("Error" . "Feature layer not found."))
La valeur de la couche d’entités obligatoire n’est pas valide ou est manquante.
- (nil ("Error" . "Sublayer not found."))
Le nom subtype obligatoire n’est pas valide ou est manquant.
Voir aussi
Vous avez un commentaire à formuler concernant cette rubrique ?