esri_label_get (AutoLISP)

返回包含文本实体标注的实体名称的列表，该标注链接到要素的指定要素属性字段。

语法

(esri_label_get field ename)

参数

• field| 字符串 | 必填 | 要素图层字段名称。
• ename | AutoCAD 实体名称 | 必填 | 链接要素的 AutoCAD 实体名称。

示例用法

尝试获取链接到所选要素 name 字段的文本实体的实体名称。

(setq text_EID (car (esri_label_get "Owner" (car (entsel)))))

结果示例用法

仅返回列表中的实体名称，该列表包含链接到所选要素 Owner 字段的文本实体的实体名称：

<Entity name: 1450e1b79f0>

返回值

该函数将返回一个值。

• 如果成功，则该函数将返回一个列表，其中包含链接到指定要素属性字段的 TEXT、MTEXT 或 ATTRIBUTE 实体的实体名称。
• 如果失败，则该函数将返回一个列表，其中第一个值为 nil，然后将返回一个包含键值 Error 的关联列表以及字符串形式的关联错误消息：(nil ("Error" . "<message>"))。

失败的返回值

出于以下任一原因，可能出现失败的返回值：

• nil

  提供的 field 名称无效或其他错误。

• (nil ("Error" . "Missing required argument."))

  未提供一个或多个必填参数。