描述
将要素类制图表达添加到地理数据库要素类。
使用
输入必须是地理数据库要素类。
将向输入要素类属性表追加两个具有指定字段名的新字段:一个字段用于识别控制各种要素类别的描绘方式的制图表达规则,另一个字段用于存储这些规则的所有特定于要素的覆盖。
指定一个导入规则图层以导入图层文件中指定渲染器类型(即类别 - 唯一值)下列出的符号选项。所有符号选项都将作为新制图表达规则复制到此要素类制图表达中。如果未指定导入规则图层,则所有要素将被分配给一个默认的制图表达规则。
如果导入规则图层与输入要素类具有相同的源要素类,则可使用分配规则 ID 参数将制图表达规则分配给要素以与导入规则图层的 RuleID 分配相匹配。
如果指定了导入规则图层并将分配规则 ID 参数设置为 ASSIGN,则所有要素将被分配给基于图层文件中指定渲染器类型(即类别 - 唯一值)下列出的符号选项的制图表达规则。如果指定了导入规则图层,但将分配规则 ID 参数设置为 NO_ASSIGN,则所有要素将被分配给一个默认的制图表达规则。
如果使用 <其他所有值> 符号化输入图层中的要素,则添加制图表达时,该符号将变为规则 ID 1。
语法
AddRepresentation(in_features, representation_name, {rule_id_field_name}, {override_field_name}, {geometry_editing_option}, {import_rule_layer}, {assign_rule_id_option})
参数 | 说明 | 数据类型 |
in_features | 要添加新要素类制图表达的输入地理数据库要素类。 | Feature Layer |
representation_name | 要添加的要素类制图表达的名称。 | String |
rule_id_field_name (可选) | RuleID 字段的名称,该字段用于保存对每个要素的制图表达规则的引用。 | String |
override_field_name (可选) | Override 字段的名称,该字段用于保存每个要素的制图表达规则的覆盖。 | String |
geometry_editing_option (可选) | 指定使用制图表达编辑工具修改要素时支持的要素类几何将会怎样。
| String |
import_rule_layer (可选) | 使用要素类制图表达符号化要素的要素图层,即从中导入制图表达规则的图层。 | Layer |
assign_rule_id_option (可选) | 指定是否将制图表达规则分配给要素以与导入规则图层的 RuleID 分配相匹配。仅当指定了导入规则图层时,此选项才可用。
| String |
代码示例
AddRepresentation 工具示例(Python 窗口)
以下 Python 窗口脚本演示了如何在立即模式下使用 AddRepresentation 工具。
import arcpy from arcpy import env env.workspace = "C:/data" arcpy.AddRepresentation_cartography("C:/data/cartography.gdb/buildings/footprints", "footprints_Rep", "RuleID", "Override", "STORE_CHANGE_AS_OVERRIDE", "C:/data/footprints.lyr", "ASSIGN")
AddRepresentation 工具示例(独立 Python 脚本)
此独立脚本显示的是使用 AddRepresentation 工具的示例。
# Name: AddRepresentation_standalone_script.py
# Description: Adds a feature class representation
# to a geodatabase feature class.
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
in_features = "C:/data/cartography.gdb/buildings/footprints"
representation_name = "footprints_Rep"
rule_id_field_name = "RuleID"
override_field_name = "Override"
geometry_editing_option = "STORE_CHANGE_AS_OVERRIDE"
import_rule_layer = "C:/data/footprints.lyr"
assign_rule_id_option = "ASSIGN"
# Execute Add Representation
arcpy.AddRepresentation_cartography(in_features,
representation_name,
rule_id_field_name,
override_field_name,
geometry_editing_option,
import_rule_layer,
assign_rule_id_option)
环境
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是