概要
レイヤーの選択フィーチャのアノテーションを作成します。指定された関連のアノテーション フィーチャクラスのアノテーション クラス プロパティで定義されたラベリング プロパティが使用されます。
使用法
アノテーションが追加されるフィーチャは、レイヤーに適用される選択セットによって決定されます。選択するセットは、[属性検索 (Select Layer by Attribute)] の使用、[空間検索 (Select Layer by Location)] の使用、または 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: はい