用于将指定图层或图层文件中的符号系统应用于输入。 此工具可应用于要素、栅格、网络分析、TIN 以及地理统计图层。
符号系统图层必须与输入图层的数据类型相匹配。 例如，不能将要素图层应用到栅格图层，反之亦然。
符号系统只能应用于几何相同的要素。 例如，点符号系统无法应用于面图层。
如果输入为要素类或数据集路径，则此工具将创建并返回应用了该工具结果的新图层。
可以在按数据更新符号系统范围参数中维护或更新符号系统范围。 默认符号系统方法是动态的。 例如，将符号系统图层中的五类“自然间断点”分类方法应用于输入图层，并更新范围值以反映输入图层的 Shape_Area 值。 维护范围选项将使用与符号系统图层相同的值。 更新范围选项将使用输入图层 Shape_Area 字段的五类“自然间断点”分类方法。
以下方法是动态的：
将按数据更新符号系统范围参数设置为维护范围可将符号系统图层值中的标注复制到输入图层值。 如果将此参数设置为更新范围，则将重新计算标注。
符号系统仅在图层持续时间内有效。 要保留图层，可通过保存 ArcGIS Pro 会话或使用将图层保存至文件工具将图层保存到图层文件。
要查看在脚本工具中创建的符号系统，该工具必须将图层作为派生的输出参数。 同样，必须将更新的输入图层参数值添加为派生模型参数模型工具，才能查看符号系统更改。
| 标注 | 说明 | 数据类型 |
输入图层 | 将应用符号系统的图层。 | Feature Layer; Raster Layer; Layer |
符号系统图层 | 包含将应用于输入图层的符号系统的图层。 支持 .lyrx 和 .lyr 文件。 | Layer |
符号系统字段 (可选) | 与符号系统图层中使用的符号系统字段相匹配的输入图层中的字段。 符号系统字段包含以下三个属性：
支持的字段类型如下：
| Value Table |
按数据更新符号系统范围 (可选) | 指定是否将更新符号系统范围。
| String |
| 标注 | 说明 | 数据类型 |
| 更新后的输入图层 | 已更新的输入图层。 | Layer |
arcpy.management.ApplySymbologyFromLayer(in_layer, in_symbology_layer, {symbology_fields}, {update_symbology})| 名称 | 说明 | 数据类型 |
in_layer | 将应用符号系统的图层。 | Feature Layer; Raster Layer; Layer |
in_symbology_layer | 包含将应用于输入图层的符号系统的图层。 支持 .lyrx 和 .lyr 文件。 | Layer |
symbology_fields [[field_type, source_field, target_field],...] (可选) | 与符号系统图层中使用的符号系统字段相匹配的输入图层中的字段。 符号系统字段包含以下三个属性：
支持的字段类型如下：
| Value Table |
update_symbology (可选) | 指定是否将更新符号系统范围。 | String |
| 名称 | 说明 | 数据类型 |
| out_layer | 已更新的输入图层。 | Layer |
以下 Python 窗口脚本演示了如何在即时模式下使用 ApplySymbologyFromLayer 函数。
import arcpy
arcpy.env.workspace = "C:/data.gdb"
arcpy.management.ApplySymbologyFromLayer("sf_points", "sf_points_water.lyrx")如下介绍了如何在独立脚本中使用 ApplySymbologyFromLayer 函数。
# Import system modules
import arcpy
# Set the current workspace
arcpy.env.workspace = "C:/data.gdb"
# Set layer to apply symbology to
inputLayer = "sf_points"
# Set layer that output symbology will be based on
symbologyLayer = "water_symbols_pnt.lyrx"
# Apply the symbology from the symbology layer to the input layer
arcpy.management.ApplySymbologyFromLayer(inputLayer, symbologyLayer)如下介绍了如何在独立脚本中使用 ApplySymbologyFromLayer 函数。
# Import system modules
import arcpy
# Set the current workspace
arcpy.env.workspace = "C:/data.gdb"
# Set layer to apply symbology to
inputLayer = "InlandEmpireBlocks"
# Set layer that output symbology will be based on
symbologyLayer = "USCensusBlocks.lyrx"
# The symbology layer is symbolized by population normalized by area.
# Symbolize the input by Pop2014 field normalized to Square Miles
symbologyFields = [["VALUE_FIELD", "#", "Pop2014"],
["NORMALIZATION_FIELD", "#", "SQ_MILES"]]
# Apply the symbology from the symbology layer to the input layer
arcpy.management.ApplySymbologyFromLayer(inputLayer, symbologyLayer,
symbologyFields)在脚本工具中，将符号系统应用于多个派生输出要素图层。 该示例工具具有以下参数：
# Import system modules
import os
import arcpy
# Get Parameters
layers = arcpy.GetParameter(0) # Accepts Feature Layers (multivalue)
sym = arcpy.GetParameter(1) # Accepts a Feature Layer
# Apply symbology to each input layer, store the result objects in a list
results = []
for layer in layers:
# Derive the name of the output featureclass
layername = arcpy.Describe(layer).baseName
outfeature = os.path.join(arcpy.env.scratchGDB, layername + "_out")
# Copy feature to get output. This step can be replaced by other
# steps that produce or manipulate a featureclass.
arcpy.management.CopyFeatures(layer, outfeature)
# Apply symbology to the final output
res = arcpy.management.ApplySymbologyFromLayer(outfeature, sym)
# Append multivalue feature
results.append(res)
# Set the symbology of the derived output parameter using the
# list of result objects
arcpy.SetParameter(2, results)