基于 Web 或文档要素图层的现有字段的内容新建文本实体。 可以将要素属性字段值链接到大多数类型的要素属性字段。 无法将报告字段链接到文本或块属性值。
语法
(esri_label_place flname field feature_ename place_point [text_size])
参数
- flname | 字符串 | 必填 | 工程图中的现有要素图层名称。
- field | 字符串 | 必填 | 标注的要素属性字段名称源。
- feature_ename | 字符串 | 必填 | 要链接到指定文本的要素的 AutoCAD 实体名称。
- place_point | 3D 点 | 必填 | 将放置新文本标注的 3D 点。
- text_size | 双精度 | 可选 | 要放置的新文本标注的文本高度。
示例用法
提示以图形方式选择 Parcels 要素图层的要素，然后指定新文本实体的位置，并将 Owner 字段值链接到文本值。(esri_label_place "Parcels" "Owner" (car (entsel)) (getpoint))
结果示例用法
创建一个新的文本实体并将其值链接到所选要素的 Owner 字段值，然后返回一个包含新文本实体名称的关联列表：
((330 . <Entity name: 21f082035d0>))返回值
以下是可能的返回值：
- 如果成功，则该函数将返回一个关联列表，其中包含已创建文本实体的实体名称。
- 如果失败，则该函数将返回一个列表，其中第一个值为 nil，然后是一个包含键值 "Error" 的关联列表以及字符串形式的关联错误消息：(nil ("Error" . "<message>"))。
失败的返回值
出于以下任一原因，可能出现失败的返回值：
- (nil ("Error" . "Field not found."))
指定的字段不是指定要素图层的有效字段。
- (nil ("Error" . "Feature layer not found."))
指定的要素图层值不是工程图中的有效要素图层。
- (nil ("Error" . "Field label already assigned."))
对于所选要素，该标注已存在。
- (nil ("Error" . "Missing required argument."))
未提供四个必填参数之一。
- (nil ("Error" . "Invalid or missing drawing object."))
未选择实体或实体无效。