Crea una nueva entidad de texto a partir del contenido de un campo existente o una capa de entidades de documento o web. 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_place flname field feature_ename place_point [text_size])
Argumentos
- flname | cadena de caracteres | obligatorio | El nombre de una capa de entidades existente en el dibujo.
- field | cadena de caracteres | obligatorio | El origen del nombre de campo de atributos de entidades para la etiqueta.
- feature_ename | cadena de caracteres | obligatorio | El nombre de entidad AutoCAD de la entidad para vincular al texto especificado.
- place_point | punto 3D | obligatorio | Punto 3D en el cual se va a colocar la nueva etiqueta de texto.
- text_size | doble | opcional | Altura del texto de la nueva etiqueta de texto que se va a colocar.
Uso de ejemplo
Solicita seleccionar gráficamente una entidad de la capa de entidades Parcels y, a continuación, especificar la ubicación de una nueva entidad de texto y vincular el valor del campo Owner al valor de texto.(esri_label_place "Parcels" "Owner" (car (entsel)) (getpoint))
Uso de ejemplo de resultado
Crea una nueva entidad de texto y vincula su valor al valor de campo Owner de la entidad seleccionada, y devuelve una lista asociada que contiene el nuevo nombre de entidad de texto:
((330 . <Entity name: 21f082035d0>))Valores de retorno
Los siguientes son los valores de retorno posibles:
- Si todo va bien, la función devuelve una lista asociada que contiene el nombre de entidad de la entidad de texto creada.
- 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 pueden producir valores de retorno fallido por cualquiera de los siguientes motivos:
- (nil ("Error" . "Field not found."))
El campo especificado no es un campo válido de la capa de entidades especificada.
- (nil ("Error" . "Feature layer not found."))
El valor de la capa de entidades especificada no es una capa de entidades válida en el dibujo.
- (nil ("Error" . "Field label already assigned."))
La etiqueta ya existe para la entidad seleccionada.
- (nil ("Error" . "Missing required argument."))
No se proporcionó uno de los cuatro argumentos requeridos.
- (nil ("Error" . "Invalid or missing drawing object."))
La entidad no se seleccionó o no es válida.