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

Résumé

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. Vous devez sélectionner préalablement le jeu en question en passant par Sélectionner une couche par attribut ou Sélectionner une couche par emplacement ou encore en interrogeant une couche dans ArcGIS Pro.

• 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 Input Layer (Couche en entrée). Sinon, l’outil Annoter les entités sélectionnées ne s’exécute pas.

• 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). Ceci enregistre les étiquettes non placées dans la classe d’entités annotations, afin de vous permettre de les placer ultérieurement dans une session Mise à jour ArcGIS Pro.

Syntaxe

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

Paramètre	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 dérivée

Nom	Explication	Type de données
out_anno_layers	Couche d’annotations en sortie.	Couche d’annotations

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.SelectLayerByAttribute_management("cities", 'NEW_SELECTION', 
                                        "County = 'Northumberland'")
arcpy.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 de la couche en utilisant 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.AnnotateSelectedFeatures_cartography(m, 'Wells', "WellsAnno 'Class 1'", 
                                               'GENERATE_UNPLACED')

Environnements

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

Informations de licence

• Basic: Non
• Standard: Oui
• Advanced: Oui