La función esri_label_generate genera etiquetas para las entidades seleccionadas de la capa de entidades especificada utilizando valores del campo de atributos especificado. Los parámetros de texto opcionales se pueden utilizar para desplazar el texto e invalidar el tamaño de texto predeterminado. Es posible vincular valores de campo de atributos de entidades a la mayoría de tipos de campos de atributos de entidades. No es posible vincular los campos de informe con valores de atributos de texto o bloque.
Sintaxis
(esri_label_generate flname field [label_properties])
Argumentos
- flname | cadena de caracteres | obligatorio | El nombre de una capa de entidades existente en el dibujo.
- field | cadena de caracteres | obligatorio | Nombre de campo de la capa de entidades asociado con la etiqueta.
- label_properties | lista asociada | opcional | Una lista asociada de propiedades de campo de capa de entidades en forma de pares de puntos tal como se define en la tabla siguiente:
| Etiqueta asociada | Tipo de valor | Descripción del valor | Requerido/opcional |
|---|---|---|---|
| "OFFSET" | lista de tres dobles | Una lista de tres dobles que incluye la distancia de desplazamiento desde el punto de etiqueta estándar en la dirección x, la dirección y la dirección z | opcional |
| "TEXTSIZE" | doble | El tamaño de texto de las etiquetas generadas | opcional |
Uso de ejemplo
Genere etiquetas para el campo Owner de la capa de entidades Parcels, donde el texto está desplazado 10 unidades hacia arriba y a la derecha del punto de etiqueta predeterminado con un tamaño de texto de 7 unidades.(esri_label_generate "Parcels" "Owner"
(list
(cons "OFFSET" '(10 10 0))
(cons "TEXTSIZE" 7.0)
)
)
Uso de ejemplo de resultado
Genera entidades de texto como etiquetas vinculadas y devuelve una lista true:
(T)Valores de retorno
- Si va bien la función devuelve una lista true: (T)
- Si se produce un error, devuelve una lista con el primer valor de nil y, a continuación, una lista asociada que contiene el valor de clave "Error" y un mensaje de error asociado como cadena de caracteres: (nil ("Error" . "<message>"))
Valores de retorno fallido
Se puede producir un valor de retorno fallido por cualquiera de los siguientes motivos:
- (nil ("Error" . "Feature layer not found."))
La capa de entidades especificada no se ha encontrado.
- (nil ("Error" . "Field not found."))
La capa de entidades de origen field no existe en el dibujo.
- (nil ("Error" . "Missing required argument."))
No se suministraron uno o más de los argumentos requeridos.