| 标注 | 说明 | 数据类型 |
输入地图
| 输入地图。 | Map |
输入要素
| 所选要素将为其创建注记的图层。 | Feature Layer |
注记图层
| 将注记转换到其中的关联要素的注记图层和指定的子图层。 | Value Table |
将未放置的标注转换为未放置的注记
(可选) | 指定否根据未放置的标注创建未放置的注记。
| Boolean |
派生输出
| 标注 | 说明 | 数据类型 |
| 输出注记图层 | 输出注记图层。 | 注记图层 |
摘要
用于为图层的所选要素创建注记。将使用在指定相关注记要素类的注记类属性中定义的标注属性。
使用情况
要注记的要素由应用于图层的选择内容决定。必须在之前的步骤中使用按属性选择图层或按位置选择图层或者通过在 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 (可选) | 指定否根据未放置的标注创建未放置的注记。
| Boolean |
派生输出
| 名称 | 说明 | 数据类型 |
| out_anno_layers | 输出注记图层。 | 注记图层 |
代码示例
以下 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 函数为图层注记所选要素。
# 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: 是