Anotar Entidades Seleccionadas (Cartografía)

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.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Mapa de entrada	El mapa de entrada.	Map
Entidades de entrada	La capa en la que las entidades seleccionadas tendrán creada una anotación.	Feature Layer
Capas de anotaciones	Las capas de anotaciones vinculadas a entidades y las subcapas especificadas que tendrán una anotación convertida en ellas.	Value Table
Convertir etiquetas no colocadas en anotaciones no colocadas (Opcional)	Especifica si se creará una anotación no colocada a partir de etiquetas no colocadas. Desactivado: la anotación solo se crea para las entidades que estén etiquetadas. Esta es la opción predeterminada. Activado: las anotaciones no colocadas se almacenan en la clase de entidad de anotación. El campo de estado de esta anotación se establece como No colocada.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Capas de anotaciones de salida	Las capas de anotaciones de salida.	Annotation Layer

Python

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

Nombre	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. ONLY_PLACED—La anotación sólo se crea para las entidades que estén etiquetadas. Esta es la opción predeterminada. GENERATE_UNPLACED—Las anotaciones no colocadas se almacenan en la clase de entidad de anotación. El campo de estado de esta anotación se establece como No colocada.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
out_anno_layers	Las capas de anotaciones de salida.	Annotation Layer

Muestra de código

Ejemplo de AnnotateSelectedFeatures (ventana de Python)

El siguiente 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.management.SelectLayerByAttribute("cities", 'NEW_SELECTION', 
                                        "County = 'Northumberland'")
arcpy.cartography.AnnotateSelectedFeatures("Map", 'cities', 
                                           "citiesAnno 'Class 1;Class 2'; citiesAltAnno 'Class 1'", 
                                           "GENERATE_UNPLACED")

Ejemplo 2 de AnnotateSelectedFeatures (script independiente)

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.cartography.AnnotateSelectedFeatures(m, 'Wells', "WellsAnno 'Class 1'", 
                                               'GENERATE_UNPLACED')

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí