该函数用于设置点要素图层的默认元素类型,如果成功,则将返回这些设置。
语法
(esri_featurelayer_setDefaultElementType flname subtype element_settings)
参数
- flname | 字符串 | 必填 | 工程图中的现有点要素图层名称。
- subtype | 字符串 | 必填 | 工程图中的现有点要素图层子类型名称。 如果未提供任何子类型,对于空字符串,请输入 ""。
- element_settings | 关联列表 | 必填 | 以点对形式表示的设置的关联列表,定义如下:
相关标注 | 值类型 | 值描述 | 必填或可选 |
---|---|---|---|
TYPE | 字符串 | POINT、Block Reference 或 AECC_COGO_POINT 的默认元素类型 | 必填 |
DESCRIPTION | 字符串 | 如果类型为 Block Reference,则为块名称;如果类型为 AECC_COGO_POINT,则为描述 | 必填 |
示例用法
将名为 Damage_to_Residential_Buildings 的要素图层(无子类型)的默认元素设置设置为名为 Damaged_Structure 的 AutoCAD 块参照。
(esri_featurelayer_setDefaultElementType
"Damage_to_Residential_Buildings"
""
(list (cons "TYPE" "Block Reference") (cons "DESCRIPTION" "Damaged_Structure"))
)
结果示例用法
设置要素图层的默认元素类型,并以关联列表形式返回 element_settings:
(("TYPE"."Block Reference")("DESCRIPTION"."Damaged_Structure"))
返回值
该函数将返回一个值。
- 如果成功,则将返回一个关联列表,其中 TYPE 值为 POINT、Block Reference 或 AECC_COGO_POINT 实体类型,DESCRIPTION 值为块参照名称或 COGO 点描述前缀。
- 如果失败,则该函数将返回一个列表,其中第一个值为 nil,然后将返回一个包含键值 Error 的关联列表以及字符串形式的关联错误消息:(nil ( "Error" . "<message>"))。
失败的返回值
出于以下任一原因,可能出现失败的返回值:
- (nil ("Error" . "Missing required argument."))
未提供三个必填参数之一。
- (nil ("Error" . "Unsupported geometry type."))
该函数仅适用于点要素图层。
- (nil ("Error" . "No feature layer specified"))
未提供任何有效的要素图层。
- (nil ("Error" . "Feature layer not found."))
文件中不存在指定的要素图层。
- (nil ("Error" . "Subtype name does not exist."))
指定的子类型不存在。