esri_featurelayer_setDefaultElementType 函数用于设置要素图层的默认元素类型,如果成功,则将返回这些设置。
语法
(esri_featurelayer_setDefaultElementType flname subtype element_settings)
参数
- flname | 字符串 | 必填 | 工程图中的现有要素图层名称。
- subtype | 字符串 | 必填 | 工程图中的现有要素图层子类型名称。 如果未提供任何子类型,对于空字符串,请使用 ""。
- element_settings | 关联列表 | 必填 | 以点对形式表示的设置的关联列表,定义如下:
| 相关标注 | 值类型 | 值描述 | 必填或可选 |
|---|---|---|---|
| TYPE | 字符串 | 类型值是在 ArcGIS for AutoCAD 中创建新要素时使用的 AutoCAD 或 Civil 3D 实体类型。 有效值为 POINT、Block Reference 和 AECC_COGO_POINT。 对于面影线,类型值为 Hatch 和 Automatic。Automatic 将忽略面的任何影线填充符号。 | 必填 |
| 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 或 COGO Point 实体类型,适用于面的 Hatch 或 Automatic,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."))
指定的子类型不存在。
- (nil ("Error" . "Incorrect argument."))
指定的 TYPE 值类型可能无效。