esri_attributes_set (AutoLISP)

Cette fonction ajoute ou modifie des attributs d’entité d’une entité de la couche d’entités. Si le champ figure sur l’entité et que le type de champ spécifié correspond à la valeur fournie, la valeur existante est remplacée.

Remarque :

Certains champs peuvent être en lecture seule. Consultez la rubrique Attributs de champ pour plus d’informations.

Syntaxe

(esri_attributes_set ename flname settings_list)

Arguments

• ename | chaîne | obligatoire | Nom de l’entité AutoCAD de l’entité.
• flname | chaîne | obligatoire | Nom de couche d’entités existant dans le dessin.
• settings_list | liste associée | obligatoire | Liste associée de noms de champs et valeurs sous forme de paires pointées.

  Etiquette associée	Type de valeur	Description de la valeur	Requis/facultatif
  "<field name>"	variante	Nom et valeur du champ. Remarque : Lorsque vous utilisez des champs contenant des valeurs de domaine codées, utilisez la valeur de description du champ et non le code.	Requis
  ...	...	...	Facultatif

Exemple d’utilisation

Définir les valeurs attributaires StreetName, Pavement et Rating du dernier objet d’entité Centerlines créé.

(esri_attributes_set 
   (entlast) 
   "Centerlines"
   (list 
     (cons "StreetName" "Main") 
     (cons "PAVEMENT"  2) 
     (cons "Rating" 0.852)
  ))

Exemple d’utilisation du résultat

Définit les valeurs attributaires StreetName, Pavement et Rating du dernier objet d’entité Centerlines créé et renvoie une liste de valeurs True :

(T)

Valeurs renvoyées

Voici les valeurs de renvoi possibles :

• En cas de réussite, la fonction renvoie une liste de valeurs True : (T)
• En cas d’échec, renvoie une liste avec la première valeur 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

Des valeurs d’échec peuvent être renvoyées dans l’un des cas suivants :

• (nil ("Error" . "Missing required argument."))

  L’un des arguments requis n’a pas été fourni.

• (nil ("Error" . "No valid fields specified."))

  Le champ spécifié n’est pas un champ valide de la couche d’entités spécifiée.

• (nil ("Error" . "Feature layer not found."))

  La valeur de la couche d’entités spécifiée n’est pas une couche d’entités valide dans le dessin.

• (nil ("Error" . "Invalid value for attribute."))

  La valeur saisie, ou sa mise en forme, n’est pas valide pour le type de champ spécifié.