esri_label_generate (AutoLISP)

La fonction esri_label_generate génère des étiquettes pour les entités sélectionnées de la couche d’entités spécifiée à l’aide des valeurs du champ attributaire spécifié. Des paramètres de texte facultatifs peuvent être utilisés pour décaler le texte et remplacer la taille du texte par défaut. 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_generate flname field [label_properties])

Arguments

• flname | chaîne | obligatoire | Nom de couche d’entités Web existant dans le dessin.
• field | chaîne | obligatoire | Nom du champ de couche d’entités associé à l’étiquette.
• label_properties | liste associée | facultatif | Liste associée des propriétés de champs des couches d’entités Web sous forme de paires pointées, comme décrites dans le tableau ci-dessous :

Etiquette associée	Type de valeur	Description de la valeur	Requis/facultatif
"OFFSET"	Liste de trois valeurs de type double	Liste de trois valeurs de type double incluant la distance de décalage à partir du point de l’étiquette standard dans la direction x, la direction y et la direction z	facultatif
"TEXTSIZE"	réel double	Taille de texte des étiquettes générées	facultatif

Exemple d’utilisation

Générer des étiquettes pour le champ Owner de la couche d’entités Parcels, avec un décalage du texte de 10 unités vers le haut et à droite du point de l’étiquette par défaut, avec une taille de texte de 7 unités.

(esri_label_generate "Parcels" "Owner"
  (list
  (cons "OFFSET" '(10 10 0))
  (cons "TEXTSIZE" 7.0)
  )
)

Exemple d’utilisation du résultat

Génère les entités de texte sous forme d’étiquettes liées et renvoie une liste de valeurs True :

(T)

Valeurs renvoyées

• En cas de réussite, la fonction renvoie une liste de valeurs True : (T)
• 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 ("Error" . "Feature layer not found."))

  Le fichier spécifié est introuvable.

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

  La couche d’entités source field ne figure pas dans le dessin.

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

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