esri_label_set (AutoLISP)

Cette fonction ajoute ou modifie la relation entre le champ attributaire d’une entité et une entité AutoCAD TEXT, MTEXT, DIMENSION ou ATTDEF.

• Si la valeur de texte de l’entité d’étiquette est modifiée, la valeur d’attribut de l’entité liée sera mise à jour automatiquement.
• Si la valeur d’attribut de l’entité liée est modifiée, la valeur de l’entité de texte liée sera mise à jour automatiquement.
• Vous pouvez lier des valeurs de champ attributaire d’entité à la plupart des types de champ attributaire d’entité.
• Vous ne pouvez pas lier des champs de suivi à des valeurs attributaires de type texte ou bloc.
• Les entités DIMENSION liées sont en lecture seule. La valeur du champ lié est dérivée du texte DIMENSION.

Syntaxe

(esri_label_set flname field feature_ename text_ename)

Arguments

• flname | chaîne | obligatoire | Nom de couche d’entités existant dans le dessin.
• field | chaîne | obligatoire | Nom de champ attributaire de couche d’entité existant
• feature_ename | chaîne | obligatoire | Nom de l’entité AutoCAD de l’entité à lier au texte spécifié.
• text_ename | chaîne | obligatoire | Nom de l’entité AutoCAD de l’entité textuelle à lier en tant que valeur attributaire de champ

Exemple d’utilisation

Invite l’utilisateur à sélectionner de manière graphique une entité de la couche d’entités Parcels puis une entité textuelle pour définir la valeur du champ Owner.

(progn
(setq feature_ent (car (entsel)))
(setq text_ent (car (entsel)))
(esri_label_set "Parcels" "Owner" feature_ent txt_ent)
)

Exemple d’utilisation du résultat

La valeur de l’entité textuelle sélectionnée est liée en tant que valeur du champ Owner des entités sélectionnées 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, elle 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

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é valide dans le dessin.