此函数用于添加或修改要素属性字段与 AutoCAD TEXT、MTEXT、DIMENSION 或 ATTDEF 实体之间的关系。
- 如果修改了标注实体的文本值，链接要素的属性值会自动更新。
- 如果修改了链接要素的属性值，则链接文本实体中的值会自动更新。
- 可以将要素属性字段值链接到大多数类型的要素属性字段。
- 无法将报告字段链接到文本或块属性值。
- 链接的 DIMENSION 实体将为只读。 链接的字段值将从 DIMENSION 文本获取。
语法
(esri_label_set flname field feature_ename text_ename)
参数
- flname | 字符串 | 必填 | 工程图中的现有要素图层名称
- field | 字符串 | 必填 | 现有要素图层属性字段名称
- feature_ename | 字符串 | 必填 | 要链接到指定文本的要素的 AutoCAD 实体名称
- text_ename | 字符串 | 必填 | 要链接为字段属性值的文本实体的 AutoCAD 实体名称
示例用法
提示以图形方式选择 Parcels 要素图层的要素，然后选择文本实体以设置 Owner 字段的值。(progn
(setq feature_ent (car (entsel)))
(setq text_ent (car (entsel)))
(esri_label_set "Parcels" "Owner" feature_ent text_ent)
)
结果示例用法
所选文本实体的值链接为所选要素 Owner 字段的值，并返回 true 列表：
(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."))
指定的要素图层值不是工程图中的有效要素图层。