返回指定要素图层的查询过滤器属性的关联列表。
此新选项可将较早版本的 esri_featurelayer_getquery 和 esri_docfeaturelayer_getquery 合并到一个函数中。 将返回现有 web 或文档要素图层的 QUERYFILTER,作为表示与该要素图层相关的查询的关联列表。
语法
(esri_featurelayer_getquery flname [subtype])
参数
- flname | 字符串 | 必填 | 工程图中的现有要素图层名称。
- subtype | 字符串 | 可选 | 工程图中的现有要素图层子类型名称。
示例用法 1
尝试获取 Shelters 要素图层的过滤器查询属性作为关联列表:
(esri_featurelayer_getquery "Shelters")
结果示例用法 1
将返回 Shelters 要素图层的过滤器查询属性作为关联列表,该列表由图层 8 的 DXF™ 代码以及父要素和子类型的 AutoCAD 图层名称的逗号分隔字符串组成:
((8 . "ESRI_Shelters,ESRI_Shelters_4,ESRI_Shelters_2,ESRI_Shelters_3,ESRI_Shelters_1,ESRI_Shelters_5,ESRI_Shelters_6"))
示例用法 2
尝试获取 Shelters 要素图层 Shelters_2 子类型的过滤器查询属性作为关联列表:
(esri_featurelayer_getquery "Shelters" "Shelters_2")
结果示例用法 2
将返回 Shelters 要素图层 Shelters_2 子类型的过滤器查询属性作为关联列表,该列表由图层 8 的 DXF™ 代码和 AutoCAD 图层名称 ESRI_Shelters_2 组成:
((8 . "ESRI_Shelters_2"))
返回值
- 如果成功, 将返回一个关联列表,表示用于定义要素图层的查询。 关联列表包含作为键值的 DXF™ 代码和关联值,它们组合起来为要素图层创建过滤查询。
- 如果失败,则该函数将返回一个列表,其中第一个值为 nil,然后是一个包含键值 "Error" 的关联列表以及字符串形式的关联错误消息:(nil ("Error" . "<message>"))
失败的返回值
出于以下任一原因,可能出现失败的返回值:
- ( nil ("Error" . "Missing required argument."))
需要要素图层值。
( nil ("Error" . "Subtype not found."))指定的要素图层子类型值在工程图中不是有效的要素子类型图层。
(nil ("Error" . "Feature layer not found."))指定的要素图层值不是工程图中的有效要素图层。