追加注记要素类 (数据管理)

摘要

创建地理数据库注记要素类，或者通过合并多个输入地理数据库要素类中的注记将现有注记要素类追加到一个包含注记类的要素类中。

使用情况

• 将多个注记要素类追加到新的注记要素类中时，输入注记要素类必须位于同一个数据库中。

• 如果在 ArcGIS Pro 中选择地理数据库注记要素或者构建定义查询，则只会将这些要素追加到输出要素类中。

• 追加关联要素的注记要素类时，所有输入注记要素类必须与同一个要素类相关联。

• 如果选择现有的输出注记要素类，则会将要素追加到该要素类中，并且此工具会在目标空间参考中对注记要素进行投影。

• 追加包含多个注记子类的注记要素类时，如果属性匹配，将合并子类。

• 创建输出关联要素的注记要素类需要 ArcGIS Desktop Standard 或 ArcGIS Desktop Advanced 许可。

• 该工具可以处理具有不同模式的注记要素类。 如果注记要素类具有相同的模式，请使用追加工具。

参数

对话框

标注	说明	数据类型
输入要素	输入注记要素将在输出要素类中形成一个注记类。	Feature Layer
输出要素类	新的或现有的注记要素类，其中将包含各输入注记要素类的注记类。	Feature Class
参考比例	在输出要素类中设置的参考比例。 以不同参考比例创建的输入要素将进行变换以与此输出参考比例相匹配。	Double
创建单个注记类 (可选)	指定如何向输出要素类添加注记要素。 选中 - 所有注记要素都将被聚合到输出要素类的一个注记类中。 未选中 - 除非这些类具有相同的名称和属性，否则在输出要素类中将为每个输入注记类创建单独的注记类。 在这种情况下，它们将被合并。 这是默认设置。	Boolean
需要从符号表中选择符号 (可选)	指定如何为新建的注记要素选择符号。 选中 - 仅当创建注记要素时，才可以使用输出要素类的符号集中的符号。 未选中 - 创建注记要素时可以使用任何符号系统。 这是默认设置。	Boolean
添加新要素时创建注记（仅限关联要素） (可选)	指定是否在添加要素时创建关联要素的注记。 选中 - 当添加关联要素时，将使用标注引擎创建关联要素注记。 这是默认设置。 未选中 - 当添加要素时，不会创建关联要素注记。	Boolean
修改关联要素形状时更新注记（仅限关联要素） (可选)	指定是否在关联要素发生更改时更新关联要素的注记。 选中 - 当更改关联要素时，将使用标注引擎更新关联要素注记。 这是默认设置。 未选中 - 当更改要素时，不会更新关联要素注记。	Boolean

Python

arcpy.management.AppendAnnotation(input_features, output_featureclass, reference_scale, {create_single_class}, {require_symbol_from_table}, {create_annotation_when_feature_added}, {update_annotation_when_feature_modified})

名称	说明	数据类型
input_features [input_features,...]	输入注记要素将在输出要素类中形成一个注记类。	Feature Layer
output_featureclass	新的或现有的注记要素类，其中将包含各输入注记要素类的注记类。	Feature Class
reference_scale	在输出要素类中设置的参考比例。 以不同参考比例创建的输入要素将进行变换以与此输出参考比例相匹配。	Double
create_single_class (可选)	指定如何向输出要素类添加注记要素。 ONE_CLASS_ONLY—所有注记要素都将被聚合到输出要素类的一个注记类中。 CREATE_CLASSES—除非这些类具有相同的名称和属性，否则在输出要素类中将为每个输入注记类创建单独的注记类。 在这种情况下，它们将被合并。 这是默认设置。	Boolean
require_symbol_from_table (可选)	指定如何为新建的注记要素选择符号。 REQUIRE_SYMBOL—仅当创建注记要素时，才可以使用输出要素类的符号集中的符号。 NO_SYMBOL_REQUIRED—创建注记要素时可以使用任何符号系统。 这是默认设置。	Boolean
create_annotation_when_feature_added (可选)	指定是否在添加要素时创建关联要素的注记。 AUTO_CREATE—当添加关联要素时，将使用标注引擎创建关联要素注记。 此设置为默认设。 NO_AUTO_CREATE—当添加要素时，不会创建关联要素注记。	Boolean
update_annotation_when_feature_modified (可选)	指定是否在关联要素发生更改时更新关联要素的注记。 AUTO_UPDATE—当更改关联要素时，将使用标注引擎更新关联要素注记。 这是默认设置。 NO_AUTO_UPDATE—当更改要素时，不会更新关联要素注记。	Boolean

代码示例

AppendAnnotation 示例（Python 窗口）

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

import arcpy
arcpy.env.workspace = "C:/data/Cobourg.gdb"
arcpy.management.AppendAnnotation(["highways", "roads"], "transport_anno", 1200, 
                                  "CREATE_CLASSES", "NO_SYMBOL_REQUIRED", 
                                  "AUTO_CREATE", "AUTO_UPDATE")

AppendAnnotation 示例（独立脚本）

以下独立脚本演示了如何使用 AppendAnnotation 函数。

# Name: AppendAnnotation_Example.py
# Description: Use AppendAnnotation to append annotation feature classes in a 
#              geodatabase

# import system modules 
import arcpy
import os

# Set environment settings - user specified
# User input geodatabase for annotation location - eg. C:/data/roads.gdb
arcpy.env.workspace = input('Location of geodatabase annotation: ')

# Create list of annotation feature classes within the geodatabase
fcList = arcpy.ListFeatureClasses("", "ANNOTATION")

# Set variables
# User input output feature class name - eg. appendedroadsAnno
outFeatureClass = arcpy.env.workspace + os.sep + \
                  input('Output annotation feature class name: ')
refScale = 1200
createClasses = "CREATE_CLASSES"
symbolReq = "NO_SYMBOL_REQUIRED"
autoCreate = "AUTO_CREATE"
autoUpdate = "AUTO_UPDATE"

# Process: Append the annotation feature classes
print("Appending annotation feature classes...")
arcpy.management.AppendAnnotation(fcList, outFeatureClass, refScale, 
                                  createClasses, symbolReq, autoCreate, 
                                  autoUpdate)

print("Annotation feature classes in {} have been appended into {}".format(
    arcpy.env.workspace, outFeatureClass))

环境

当前工作空间, 临时工作空间, 自动提交

许可信息

• Basic: 受限
• Standard: 是
• Advanced: 是