入力フィールドまたは式の文字列を入力スタイルのシンボル名に一致させることで、入力フィールドまたは式に基づいた入力レイヤーの個別値シンボルを作成します。
入力レイヤーに対して個別値シンボルが作成されます。レイヤーが現在のマップに含まれている場合、そのレイヤーは更新されます。レイヤーが現在のマップに含まれていない場合、シンボル化されたレイヤーがマップに追加されます。いずれの場合も、既存のレイヤー シンボルは上書きされます。
個別値シンボル クラスは、[値の一致 (フィールドまたは式)] パラメーターによって作成され、名前がフィールド値または生成される式の値と一致する入力 [スタイル] パラメーターのシンボルでシンボル化されます。ツールが 1 つのフィールドの値を照合し、そのフィールドがサブタイプ フィールドであるか、コード値ドメインを含む場合、シンボルはそのサブタイプまたはドメイン説明に一致させられます。
ポイント フィーチャ レイヤーおよびマルチポイント フィーチャ レイヤーは、スタイル内のポイント シンボルと照合されます。ポリライン フィーチャ レイヤーはライン シンボルと照合されます。ポリゴン フィーチャ レイヤーはポリゴン シンボルと照合されます。マルチパッチ フィーチャ レイヤーはメッシュ シンボルと照合されます。
一致するデータが存在しない場合、シンボル クラスは他のすべての値に対してデフォルト シンボルで描画されます。
| ラベル | 説明 | データ タイプ |
入力レイヤー
| 一致したシンボルを個別値シンボル クラスとして適用する入力レイヤーまたはレイヤー ファイル。入力レイヤーには、ポイント、ライン、ポリゴン、マルチポイント、またはマルチパッチ シンボルを含めることができます。レイヤー上の既存のシンボルが上書きされます。 | Feature Layer |
値の一致 (フィールドまたは式) | 入力レイヤーのシンボル表示の基となるフィールドまたは式。フィールド値または生成される式の値は、指定したスタイル内のシンボル名と照合され、生成されるシンボル クラスにシンボルを割り当てます。 | Calculator Expression |
スタイル
| フィールドまたは式の値と一致する名前のシンボルを含むスタイル。 | String |
| ラベル | 説明 | データ タイプ |
| 出力レイヤー | 更新されたシンボル レイヤー。 | フィーチャ レイヤー |
arcpy.management.MatchLayerSymbologyToAStyle(in_layer, match_values, in_style)
| 名前 | 説明 | データ タイプ |
in_layer | 一致したシンボルを個別値シンボル クラスとして適用する入力レイヤーまたはレイヤー ファイル。入力レイヤーには、ポイント、ライン、ポリゴン、マルチポイント、またはマルチパッチ シンボルを含めることができます。レイヤー上の既存のシンボルが上書きされます。 | Feature Layer |
match_values | 入力レイヤーのシンボル表示の基となるフィールドまたは式。フィールド値または生成される式の値は、指定したスタイル内のシンボル名と照合され、生成されるシンボル クラスにシンボルを割り当てます。 | Calculator Expression |
in_style | フィールドまたは式の値と一致する名前のシンボルを含むスタイル。 | String |
| 名前 | 説明 | データ タイプ |
| out_layer | 更新されたシンボル レイヤー。 | フィーチャ レイヤー |
次の Python ウィンドウ スクリプトは、イミディエイト モードで MatchLayerSymbologyToAStyle 関数を使用する方法を示しています。
import arcpy
arcpy.management.MatchLayerSymbologyToAStyle("Streets", "$feature.RoadClass",
r"C:\RoadClasses.stylx")