Эта функция добавляет или изменяет отношение между полем атрибута объекта и элементами AutoCAD TEXT, MTEXT, DIMENSION или ATTDEF.
- Если текстовое значение подписи объекта меняется, атрибутивное значение связанного объекта будет обновлено автоматически.
- Если атрибутивное значение связанного объекта меняется, значение связанного текстового объекта будет обновлено автоматически.
- Можно связать значения атрибутивных полей объекта с большинством видов атрибутивных полей объекта.
- Вы не можете связать поля отчета с текстом или значениями атрибутов блока.
- Связанные элементы DIMENSION будут предназначены только для чтения. Значение связанного поля получено из текста DIMENSION.
Синтаксис
(esri_label_set flname field feature_ename text_ename)
Аргументы
- flname | string | обязательный | Имя существующего векторного слоя чертежа
- field | string | обязательный | Имя поля атрибута существующего векторного слоя
- feature_ename | string | обязательный | Имя элемента AutoCAD объекта для связи с указанным текстом
- text_ename | string | обязательный | Имя элемента AutoCAD текстового элемента для связи в качестве значения поля атрибута
Пример использования
Предлагает графически выбрать объект векторного слоя Parcels, а затем текстовый элемент для установки Owner значения поля.(progn
(setq feature_ent (car (entsel)))
(setq text_ent (car (entsel)))
(esri_label_set "Parcels" "Owner" feature_ent text_ent)
)
Результат из примера использования
Значение выбранного текстового элемента связывается в качестве значения поля Owner выбранного объекта и возвращает список истинных значений:
(T)
Возвращаемые значения
Ниже перечислены возможные возвращаемые значения:
- В случае успеха функция возвращает список значений true: (T)
- В случае неудачи она возвращает список с первым значением nil, а затем связанный список, содержащий значение ключа "Error" и соответствующее сообщение об ошибке в виде строки: (nil ("Error" . "<message>")).
Не удалось возвратить значения
Неудачное возвращение значения может произойти по любой из следующих причин:
- (nil ("Error" . "Missing required argument."))
Не указан один из обязательных аргументов.
- (nil ("Error" . "No valid fields specified."))
Указанное поле не является допустимым полем указанного векторного слоя.
- (nil ("Error" . "Feature layer not found."))
Заданный векторный слой не является допустимым слоем чертежа.