Esta función agrega o modifica la relación entre un campo de atributo de una entidad y una entidad TEXT, MTEXT, DIMENSION o ATTDEF de AutoCAD.
- Si se modifica el valor de texto de la entidad de la etiqueta, el valor del atributo de la entidad vinculada se actualizará automáticamente.
- Si el valor de atributo de la entidad vinculada se modifica, el valor de la entidad de texto vinculada se actualizará automáticamente.
- 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.
- Las entidades DIMENSION vinculadas serán de solo lectura. El valor de campo vinculado se deriva del texto DIMENSION.
Sintaxis
(esri_label_set flname field feature_ename text_ename)
Argumentos
- flname | cadena de caracteres | obligatorio | El nombre de una capa de entidades existente en el dibujo
- field | cadena de caracteres | obligatorio | Un nombre de campo de atributo de capa de entidades existente
- feature_ename | cadena de caracteres | obligatorio | El nombre de entidad AutoCAD de la entidad para vincular al texto especificado
- text_ename | cadena de caracteres | obligatorio | El nombre de entidad AutoCAD de la entidad de texto para vincular como un valor de atributo de campo
Uso de ejemplo
Solicita seleccionar gráficamente una entidad de la capa de entidades Parcels y luego una entidad de texto para establecer el valor del campo Owner.(progn
(setq feature_ent (car (entsel)))
(setq text_ent (car (entsel)))
(esri_label_set "Parcels" "Owner" feature_ent text_ent)
)
Uso de ejemplo de resultado
El valor de la entidad de texto seleccionada se vincula como el valor del campo Owner de la entidad seleccionada y devuelve una lista true:
(T)
Valores de retorno
Los siguientes son los valores de retorno posibles:
- 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 pueden producir valores de retorno fallido por cualquiera de los siguientes motivos:
- (nil ("Error" . "Missing required argument."))
No se ha suministrado uno de los argumentos requeridos.
- (nil ("Error" . "No valid fields specified."))
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.