AutoCAD ドローイングにドキュメント フィーチャ レイヤー定義を追加します。
使用法:
- FEATURE_LAYER_PROPERTIES を省略した場合は、クエリ フィルターなしでフィーチャ レイヤーが作成され、GEOMTYPE がポイントに設定されます。
- オプション パラメーター LAYERFILTER を指定すると、レイヤー リストが QUERYFILTER として使用されます。
- レイヤー リストよりも高度なクエリ フィルターが必要な場合は、esri_docfeaturelayer_setquery 関数を別に使用します。
- 新しいフィーチャ レイヤー名がすでに存在している状態で指定した名前を追加したものの、連番を付加した場合
構文
(esri_docfeaturelayer_add flname [featurelayer_properties])
引数
- flname | 文字列 | 必須 | 新しいドキュメント フィーチャ レイヤー名。
- featurelayer_properties | 関連リスト | オプション | フィーチャ レイヤーのプロパティ。
関連ラベル 値のタイプ 値の説明 必須またはオプション "GEOMTYPE " 文字列
新しいフィーチャ レイヤーのジオメトリック タイプ: {"Polygon"、 "Point",、"Polyline"、"Annotation" または "Multipatch"}
オプション (デフォルトは Point)
"LAYERFILTER" 文字列
カンマで区切られた 1 つまたは複数の AutoCAD レイヤー名を単一の文字列として指定します。これにより、新規のフィーチャクラスの QUERYFILTER が定義されます。
注意:
- デフォルト値は「*」であり、すべてのレイヤーを意味します。
- esri_docfeaturelayer_setquery 関数を使用して、複雑な QUERYFILTER を作成します。
オプション
使用例
フィーチャ レイヤーを定義するエンティティが AutoCAD STREETS レイヤー上にある、ROADS という名前のポリライン ドキュメント フィーチャの追加を試行します。(esri_docfeaturelayer_add "ROADS"
(list
(cons "GEOMTYPE" "POLYLINE")
(cons "LAYERFILTER" "STREETS")
))
使用例の結果
フィーチャ レイヤーを定義するエンティティが AutoCAD STREETS レイヤー上にある、ROADS という名前のポリライン ドキュメント フィーチャを追加し、新しいフィーチャ レイヤー名を含むリストを返します。
("ROADS")
戻り値
- 正常に実行された場合、新しいドキュメント フィーチャ レイヤーの名前を含むリストが返されます。
- 実行に失敗した場合、nil の最初の値を含むリスト、キー値 "Error" を含む関連リスト、文字列としての関連エラー メッセージ (nil ("Error" . "<message>")) が順番に返されます。
失敗した場合の戻り値
失敗の戻り値が返された理由として、次のようなことが考えられます。
- (nil ("Error" . "Missing required argument."))
1 つ以上の必須引数が指定されていません。
次もご参照ください。
「(esri_webfeaturelayer_add)」| 新しい Web フィーチャ レイヤーを追加します。
「(esri_weblayer_add)」| 新しい Web レイヤー (イメージ レイヤー、マップ イメージ レイヤー、または Web フィーチャ レイヤー) を追加します。
「(esri_docfeaturelayer_setquery)」| ドキュメント フィーチャ レイヤーのクエリ フィルターを定義します。