esri_label_generate (AutoLISP)

esri_label_generate 函数使用指定属性字段的值为指定要素图层的选定要素生成标注。 可选文本参数可用于偏移文本并覆盖默认文本大小。 可以将要素属性字段值链接到大多数类型的要素属性字段。 无法将报告字段链接到文本或块属性值。

语法

(esri_label_generate flname field [label_properties])

参数

• flname | 字符串 | 必填 | 工程图中的现有要素图层名称。
• field | 字符串 | 必填 | 与标注关联的要素图层字段名称。
• label_properties | 关联列表 | 可选 | 点对形式的要素图层字段属性的关联列表，如下表定义：

相关标注	值类型	值描述	必填/可选
"OFFSET"	三个双精度值列表	三个双精度值列表，包含相对于 x、y 和 z 方向上标准标注点的偏移距离	可选
"TEXTSIZE"	双精度	生成的标注的文本大小	可选

示例用法

为 Parcels 要素图层的 Owner 字段生成标注，其中文本相对于默认标注点向上和向右偏移 10 个单位，文本大小为 7 个单位。

(esri_label_generate "Parcels" "Owner"
  (list
  (cons "OFFSET" '(10 10 0))
  (cons "TEXTSIZE" 7.0)
  )
)

结果示例用法

以链接标注形式生成文本实体并返回一个 true 列表：

(T)

返回值

• 如果成功，则该函数将返回一个 true 列表：(T)
• 如果失败，则该函数将返回一个列表，其中第一个值为 nil，然后是一个包含键值 "Error" 的关联列表以及字符串形式的关联错误消息：(nil ("Error" . "<message>"))

失败的返回值

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

• (nil ("Error" . "Feature layer not found."))

  未找到指定的要素图层。

• (nil ("Error" . "Field not found."))

  工程图中不存在源要素图层 field。

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

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