esri_label_get (AutoLISP)

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

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 d’entité de l’entité textuelle liée au champ Owner 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 d’entité à partir de la liste contenant le nom d’entité de l’entité textuelle liée au champ Owner de l’entité sélectionnée :

<Entity name: 1450e1b79f0>

Valeurs renvoyées

Voici les valeurs de renvoi possibles :

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

  Le nom de champ 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.

• (nil ("Error" . "No label found."))

  L’entité sélectionnée ne se trouve pas dans la couche d’entités.