esri_label_get (AutoLISP)

Renvoie une liste contenant le nom de l’entité de l’étiquette de l’entité textuelle liée à un champ attributaire d’une entité spécifiée.

Syntaxe

(esri_label_get field ename)

Arguments

• field| chaîne | obligatoire | Nom de champ de la couche d’entités.
• ename | Nom de l’entité AutoCAD | obligatoire | Nom de l’entité AutoCAD de l’entité liée.

Exemple d’utilisation

Essayer d’obtenir le nom de l’entité de l’entité textuelle liée au champ name de l’entité sélectionnée.

(setq text_EID (car (esri_label_get "Owner" (car (entsel)))))

Exemple d’utilisation du résultat

Renvoie juste le nom de l’entité à partir de la liste contenant le nom de l’entité de l’entité textuelle liée au champ Owner de l’entité sélectionnée :

<Entity name: 1450e1b79f0>

Valeurs renvoyées

Cette fonction renvoie une valeur.

• En cas de réussite, renvoie une liste contenant les noms des entités de l’entité TEXT, MTEXT ou ATTRIBUTE liée au champ attributaire de l’entité spécifiée.
• 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

Un échec peut être dû par exemple aux raisons suivantes :

• nil

  Le nom field fourni n’est pas valide ou il existe d’autres erreurs.

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

  Un ou plusieurs des arguments requis n’a pas été fourni.