esri_label_place (AutoLISP)

La fonction esri_label_place crée une nouvelle entité 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 [text_size])

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 textuelle sera placée.
• text_size | double | facultatif | Hauteur de texte de la nouvelle étiquette de texte à placer.

Exemple d’utilisation

Essayer de sélectionner de manière graphique une entité de la couche d’entités Parcels, puis spécifier l’emplacement d’une nouvelle entité textuelle et lier la valeur du champ Owner à la valeur du texte.

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

Exemple d’utilisation du résultat

Crée une entité texte et lie sa valeur à la valeur du champ Owner de l’entité sélectionnée, puis renvoie une liste associée contenant le nom de la nouvelle entité 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, 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

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 arguments obligatoires n’a pas été fourni.

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

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

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

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