esri_label_get (AutoLISP)

フィーチャの指定されたフィーチャ属性フィールドにリンクされたテキスト エンティティ ラベルのエンティティ名を含むリストを返します。

構文

(esri_label_get field ename)

引数

• field | 文字列 | 必須 | フィーチャ レイヤーのフィールド名。
• ename | AutoCAD エンティティ名 | 必須 | リンクされているフィーチャの AutoCAD エンティティ名。

使用例

選択したフィーチャの name フィールドにリンクされているテキスト エンティティのエンティティ名の取得を試行します。

(setq text_EID (car (esri_label_get "Owner" (car (entsel)))))

使用例の結果

選択したフィーチャの Owner フィールドにリンクされているテキスト エンティティのエンティティ名を含むリストからエンティティ名だけを返します。

<Entity name: 1450e1b79f0>

戻り値

この関数は値を返します。

• 正常に実行された場合、指定されたフィーチャ属性フィールドにリンクされた TEXT、MTEXT または ATTRIBUTE エンティティのエンティティ名を含むリストを返します。
• 実行に失敗した場合、nil の最初の値を含むリスト、キー値 Error を含む関連リスト、文字列としての関連エラー メッセージ (nil ("Error" . "<message>")) が順番に返されます。

失敗した場合の戻り値

失敗の戻り値が返された理由として、次のようなことが考えられます。

• nil

  指定された field 名が無効か、その他のエラーが発生しました。

• (nil ("Error" . "Missing required argument."))

  1 つ以上の必須引数が指定されていません。