esri_featurelayer_select (AutoLISP)

Cette fonction renvoie un ensemble de sélection AutoCAD filtré selon la couche d’entités spécifiée et un sous-type facultatif dans le dessin et éventuellement un ensemble de sélection spécifié. Cette fonction est semblable à l’option Objects (Objets) de l’outil Select Features (Sélectionner des entités) du menu contextuel d’une couche d’entités Web ou de document dans la fenêtre Esri Contents (Contenu Esri).

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 pas de 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 l’ensemble de sélection est omis, 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 tous les 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

Exemple d’utilisation 1

Essayer de créer 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

Essaye de créer 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 où 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 où les valeurs du champ capacity sont supérieures à 400 :

<Selection set: 30>

Valeurs renvoyées

• En cas de réussite, renvoie un objet d’ensemble de sélection AutoCAD.
• En cas d’échec, renvoie une liste avec la première valeur de nil puis une liste associée contenant la valeur principale "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" . "No feature layer specified."))

  La valeur de la couche d’entités requise n’est pas valide ou est manquante.

• (nil ("Error" . "Sublayer not found."))

  Le nom subtype requis n’est pas valide ou est manquant.

Voir aussi

(esri_featurelayer_selectspecial)