Resumen
Crea una anotación para las entidades seleccionadas de una capa. Se utilizan las propiedades de etiquetado definidas en las propiedades de clase de anotación de las clases de entidad de anotación relacionadas especificadas.
Uso
Las entidades que se anotarán las determina una selección aplicada a una capa. La selección se debe determinar en un paso previo con Seleccionar capa por atributo, Seleccionar capa por ubicación o consultando una capa de mapa en ArcGIS Pro.
El mapa determina qué clases de anotación vinculada a entidad se enumeran. Puede haber muchas clases de anotación vinculada a entidad, pero solo se enumerarán las que aparezcan en el mapa. Marque las clases de anotación en las que desea guardar la anotación.
La Capa de entrada debe incluir una selección; de lo contrario, Anotar entidades seleccionadas fallará.
La Capa de entrada debe tener una anotación vinculada a entidad; de lo contrario, Anotar entidades seleccionadas fallará.
Es posible que algunas etiquetas no se visualicen en el mapa debido a que no hay espacio para ellas. Para convertir estas etiquetas, marque la casilla de verificación Convertir etiquetas no colocadas en anotaciones. De este modo, se guardan las etiquetas no colocadas en la clase de entidad de anotación, lo que le permite posicionarlas después en una sesión de edición de ArcGIS Pro.
Sintaxis
AnnotateSelectedFeatures(in_map, in_layer, anno_layers, {generate_unplaced})
Parámetro | Explicación | Tipo de datos |
in_map | El mapa de entrada. | Map |
in_layer | La capa en la que las entidades seleccionadas tendrán creada una anotación. | Feature Layer |
anno_layers [[annotation_layer, sublayer;sublayer],...] | Las capas de anotaciones vinculadas a entidades y las subcapas especificadas que tendrán una anotación convertida en ellas. | Value Table |
generate_unplaced (Opcional) | Especifica si se creará una anotación no colocada a partir de etiquetas no colocadas.
| Boolean |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_anno_layers | Las capas de anotaciones de salida. | Capa de anotaciones |
Muestra de código
El script de la ventana de Python muestra cómo utilizar la herramienta AnnotateSelectedFeatures en el modo inmediato.
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")
Script independiente que anota entidades seleccionadas para la capa mediante la función 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')
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí