将图层符号系统与样式匹配 (数据管理)

描述

可将输入字段或表达式字符串与输入样式中的符号名称进行匹配，从而根据输入字段或表达式为输入图层创建唯一值符号系统。

使用方法

• 唯一值符号系统将针对输入图层进行创建。如果该图层位于当前地图中，则系统将更新该图层。否则，符号化图层随即会添加到地图中。无论如何，现有的图层符号系统都会被覆盖。

• 唯一值符号类将由匹配值（字段或表达式）参数进行创建，并用输入样式参数中的符号进行符号化，其名称将与字段值或结果表达式值相匹配。如果工具与单个字段中的值相匹配，且该字段是子类型字段或具有编码值属性域，则符号将与子类型或属性域描述相匹配。

• 点和多点要素图层在样式上将与点符号相匹配。折线要素图层将与线符号相匹配。面要素图层将与面符号相匹配。多面体要素图层将与网格符号相匹配。

• 如果找不到匹配项，则将使用所有其他值的默认符号来绘制符号类。

语法

arcpy.management.MatchLayerSymbologyToAStyle(in_layer, match_values, in_style)

参数	说明	数据类型
in_layer	匹配符号作为唯一值符号类应用于其上的输入图层或图层文件。输入图层可以包含点、线、面、多点或多面体符号系统。图层上的现有符号系统将被覆盖。	Feature Layer
match_values	用于符号化输入图层的字段或表达式。字段值或结果表达式值与指定样式的符号名称相匹配，以将符号分配给结果符号类。	Calculator Expression
in_style	包含名称与字段或表达式值相匹配的符号的样式。	String

派生输出

名称	说明	数据类型
out_layer	已更新的符号化图层。	要素图层

代码示例

MatchLayerSymbologyToAStyle 示例（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 MatchLayerSymbologyToAStyle 函数。

import arcpy
arcpy.management.MatchLayerSymbologyToAStyle("Streets", "$feature.RoadClass", 
                                             r"C:\RoadClasses.stylx")

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是