Annoter les entités sélectionnées (Cartographie)

Synthèse

Crée une annotation pour les entités sélectionnées d’une couche. Les propriétés d’étiquetage définies dans les propriétés de la classe d’annotations des classes d’entités annotations associées spécifiées sont utilisées.

Utilisation

• Les entités à annoter sont déterminées par une sélection appliquée à une couche. La sélection doit être effectuée préalablement à l’aide de Sélectionner une couche par attributs ou Sélectionner une couche par localisation, ou en interrogeant une couche de carte dans ArcGIS AllSource.

• La carte détermine les classes d’annotations liées aux entités qui sont répertoriées. Plusieurs classes d’annotations liées aux entités peuvent être présentes, mais seules celles figurant sur la carte sont répertoriées. Sélectionnez les classes d’annotations dans lesquelles vous souhaitez stocker l’annotation.

• Une sélection doit être indiquée pour Input Layer (Couche en entrée). Sinon, l’outil Annoter les entités sélectionnées ne s’exécute pas.

• Une annotation liée aux entités doit être indiquée pour Couche en entrée. Autrement, l’outil Annoter les entités sélectionnées échoue.

• Certaines étiquettes peuvent ne pas s'afficher sur la carte du fait d'un manque d'espace. Pour convertir ces étiquettes, cochez la case Convert unplaced labels to annotation (Convertir les étiquettes non placées en annotation). Cette option permet d’enregistrer les étiquettes non placées dans la classe d’entités annotations pour que vous puissiez les positionner ultérieurement dans une session de mise à jour ArcGIS AllSource.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Carte en entrée	Carte en entrée.	Map
Entités en entrée	Couche pour laquelle une annotation sera associée aux entités sélectionnées.	Feature Layer
Couches d’annotations	Couche d’annotations liées aux entités et les sous-couches spécifiées dans lesquelles l’annotation sera convertie.	Value Table
Convertir les étiquettes non placées en annotations non placées (Facultatif)	Indique si vous voulez créer des annotations non placées à partir d’étiquettes non placées. Désactivée - Des annotations seront créées uniquement pour les entités étiquetées. Il s’agit de l’option par défaut. Activée - Les annotations non placées seront stockées dans la classe d'entités annotations. Le champ d'état de ces annotations est défini sur Non placée.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Couches d’annotations en sortie	Couches d’annotations en sortie.	Annotation Layer

Python

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

Nom	Explication	Type de données
in_map	Carte en entrée.	Map
in_layer	Couche pour laquelle une annotation sera associée aux entités sélectionnées.	Feature Layer
anno_layers [[annotation_layer, sublayer;sublayer],...]	Couche d’annotations liées aux entités et les sous-couches spécifiées dans lesquelles l’annotation sera convertie.	Value Table
generate_unplaced (Facultatif)	Indique si vous voulez créer des annotations non placées à partir d’étiquettes non placées. ONLY_PLACED—Des annotations seront créées uniquement pour les entités étiquetées. Il s’agit de l’option par défaut. GENERATE_UNPLACED—Les annotations non placées seront stockées dans la classe d'entités annotations. Le champ d'état de ces annotations est défini sur Non placée.	Boolean

Sortie obtenue

Nom	Explication	Type de données
out_anno_layers	Couches d’annotations en sortie.	Annotation Layer

Exemple de code

Exemple d’utilisation de l’outil AnnotateSelectedFeatures (fenêtre Python)

Le script de fenêtre Python suivant montre comment utiliser l'outil AnnotateSelectedFeatures en mode immédiat.

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")

Exemple 2 d’utilisation de l’outil AnnotateSelectedFeatures (script autonome)

Script autonome qui annote les entités sélectionnées pour la couche à l’aide de la fonction 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')

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.