esri_docfeaturelayer_add (AutoLISP)

将文档要素图层定义添加到 AutoCAD 工程图。

使用方法：

• 如果忽略 FEATURE_LAYER_PROPERTIES，则将创建要素图层（不使用查询过滤器），并将 GEOMTYPE 设置为点。
• 如果包含可选参数 LAYERFILTER，那么图层列表将用作 QUERYFILTER。
• 如果需要比图层列表更复杂的查询过滤器，则使用单独的 esri_docfeaturelayer_setquery 函数。
• 如果新要素图层名称已存在，则将添加指定名称，但包含一个连续的附加编号

语法

(esri_docfeaturelayer_add flname [featurelayer_properties])

参数

• flname | 字符串 | 必填 | 新文档要素图层名称。
• featurelayer_properties | 关联列表 | 可选 | 要素图层属性。

  相关标注	值类型	值描述	必选或可选
  "GEOMTYPE "	字符串	新要素图层的几何类型：{"Polygon"、 "Point"、"Polyline"、"Annotation" 或 "Multipatch"}	可选（Point 为默认值。）
  "LAYERFILTER"	字符串	一个或多个 AutoCAD 图层名称，以逗号分隔，采用单个字符串形式，用于定义新要素类的 QUERYFILTER。 注： 默认为“*”，表示所有图层。 使用 esri_docfeaturelayer_setquery 函数创建复杂的 QUERYFILTER。	可选

示例用法

尝试添加一个名为 ROADS 的折线文档要素，其中定义要素图层的实体位于 AutoCAD STREETS 图层上：

(esri_docfeaturelayer_add "ROADS"
(list
(cons "GEOMTYPE" "POLYLINE")
(cons "LAYERFILTER" "STREETS")
))

结果示例用法

添加一个名为 ROADS 的折线文档要素，其中定义要素图层的实体位于 AutoCAD STREETS 图层上，并返回一个包含新要素图层名称的列表：

("ROADS")

返回值

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

失败的返回值

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

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

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

另请参阅

(esri_webfeaturelayer_add) | 添加新的 web 要素图层。

(esri_weblayer_add) | 添加新的 web 图层：图像图层、地图图像图层或 web 要素图层。

(esri_docfeaturelayer_setquery) | 定义文档要素图层查询过滤器。