注记所选要素 (制图)

描述

用于为图层的所选要素创建注记。将使用在指定相关注记要素类的注记类属性中定义的标注属性。

使用方法

• 要注记的要素由应用于图层的选择内容决定。必须在之前的步骤中使用按属性选择图层或按位置选择图层或者通过在 ArcGIS Pro 中查询地图图层来确定选择内容。

• 地图可以决定列出的关联要素的注记类。可能存在许多关联要素的注记类，但仅列出地图中的关联要素的注记类。选中想要存储注记的注记类。

• 输入图层必须包含选择内容；否则，注记所选要素将失败。

• 输入图层必须具有关联要素的注记；否则，注记所选要素将失败。

• 某些标注目前可能未显示在地图上，原因是没有供它们显示的空间。要转换这些标注，请选中将未放置的标注转换为注记复选框。这样便可将未放置的标注保存到注记要素类中，以便今后在 ArcGIS Pro 编辑会话中可以找到它们。

语法

arcpy.cartography.AnnotateSelectedFeatures(in_map, in_layer, anno_layers, {generate_unplaced})

参数	说明	数据类型
in_map	输入地图。	Map
in_layer	所选要素将为其创建注记的图层。	Feature Layer
anno_layers [[annotation_layer, sublayer;sublayer],...]	将注记转换到其中的关联要素的注记图层和指定的子图层。	Value Table
generate_unplaced （可选）	指定否根据未放置的标注创建未放置的注记。 ONLY_PLACED —仅为当前已标注的要素创建注记。这是默认设置。 GENERATE_UNPLACED —未放置的注记将存储到注记要素类中。这些注记的状态字段将设置为“未放置”。	Boolean

派生输出

名称	说明	数据类型
out_anno_layers	输出注记图层。	注记图层

代码示例

AnnotateSelectedFeatures 示例（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 AnnotateSelectedFeatures 工具。

import arcpy
arcpy.env.workspace = "c:/data/Canada.gdb"
arcpy.SelectLayerByAttribute_management("cities", 'NEW_SELECTION', 
                                        "County = 'Northumberland'")
arcpy.AnnotateSelectedFeatures("Map", 'cities', 
                               "citiesAnno 'Class 1;Class 2'; citiesAltAnno 'Class 1'", 
                               "GENERATE_UNPLACED")

AnnotateSelectedFeatures 示例 2（独立脚本）

此独立脚本使用 AnnotateSelectedFeatures 函数为图层注记所选要素。

# Name: AnnotateSelectedFeatures.py
# Description: Annotate features based on a selection in a map 
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:\\data\\Northumberland.gdb"
# Execute Annotate Selected Features
p = arcpy.mp.ArcGISProject("C:\\data\\Northumberland.aprx")
for m in p.listMaps():
				arcpy.AnnotateSelectedFeatures_cartography(m, 'Wells', "WellsAnno 'Class 1'", 
                                               'GENERATE_UNPLACED')

环境

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

许可信息

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