esri_label_place (AutoLISP)

Crée une entité de texte à partir du contenu d’un champ existant d’une couche d’entités Web ou de document. 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.

Syntaxe

(esri_label_place flname field feature_ename place_point)

Arguments

• flname | chaîne | obligatoire | Nom de couche d’entités existant dans le dessin.
• field | chaîne | obligatoire | Source du nom du champ attributaire de l’entité pour l’étiquette.
• feature_ename | chaîne | obligatoire | Nom d’entité AutoCAD de l’entité à lier au texte spécifié.
• place_point | point 3D | obligatoire | Point 3D où la nouvelle étiquette de texte sera placée.

Exemple d’utilisation

Invite l’utilisateur à sélectionner de manière graphique une entité de la couche d’entités Parcels, puis spécifie l’emplacement d’une nouvelle entité textuelle et lie la valeur du champ Owner à la valeur textuelle.

(esri_label_place "Parcels" "Owner" (car (entsel)) (getpoint))

Exemple d’utilisation du résultat

Crée une nouvelle entité textuelle et lie sa valeur à la valeur du champ Owner de l’entité sélectionnée, puis renvoie une liste associée contenant le nom d’entité du nouveau texte :

((330 . <Entity name: 21f082035d0>))

Valeurs renvoyées

Voici les valeurs de renvoi possibles :

• En cas de réussite, la fonction renvoie une liste associée contenant le nom d’entité de l’entité textuelle créé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

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

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

  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" . "Field label already assigned."))

  L’étiquette existe déjà pour l’entité sélectionnée.

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

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

• (nil ("Error" . "Invalid or missing drawing object."))

  L’entité n’a pas été sélectionnée ou n’est pas valide.