CADLabo.comCAD / LISP / AUTOMATION
DCL解説

DCL入門3|入力した値をAutoLISPで受け取る

DCLで入力画面を作るのTips一覧
このページでわかること

画面に入力した値を、LISP側で受け取ってみましょう。部品をkeyで結び、action_tileの通知とget_tileの読み取りを使い分けます。

まずはここから

初めての方は、こちらも読んでみてください。

順番に試してみましょう

  1. 入力欄のkeyをDCLファイルで確認します。
  2. new_dialogの後に、掲載例のaction_tileを登録します。
  3. 値を入力してOKを押し、LISP側へ渡る値を確認します。
  4. キャンセルした場合に、入力値を使う処理が実行されないか確認します。

DCLとAutoLISPの連携の仕組み

DCLで定義した edit_box は、AutoLISPから操作するために key 属性を持っています。この key を使って、AutoLISP側で値を受け取るには action_tile 関数を使います。

Step 1:DCLファイルの確認

まずは、前回作成した simpleedit.dcl を再確認しておきましょう。

掲載コード
inputdlg : dialog {
  label = "名前を入力してください";
  : edit_box {
    key = "username";
    label = "名前";
    value = "";
  }
  ok_cancel;
}
  • key = "username" がポイント。AutoLISP側でこの名前を使って値を受け取ります。

Step 2:AutoLISPで値を受け取る

以下のコードでは、username タイルから入力値を取得し、処理しています。

掲載コード
(defun C:getname ( / dcl_id result name )
  (setq dcl_id (load_dialog "simpleedit.dcl"))
  (if (not (new_dialog "inputdlg" dcl_id))
    (prompt "\nDCLの読み込みに失敗しました。")
  )

  ;; 入力値を取得するアクションを設定
  (action_tile "username" "(setq name $value)")

  ;; OKボタンでダイアログを終了
  (action_tile "accept" "(done_dialog 1)")
  ;; キャンセルボタンで終了
  (action_tile "cancel" "(done_dialog 0)")

  ;; ダイアログを表示
  (setq result (start_dialog))
  (unload_dialog dcl_id)

  ;; 入力結果を処理
  (if (= result 1)
    (progn
      (prompt (strcat "\n入力された名前は: " name))
      ;; ここに処理を追加可能(例:図面に文字を配置など)
      (command "_.text" "j" "mc" (getpoint "\n配置位置を指定: ") 2.5 0 name)
    )
    (prompt "\nキャンセルされました。")
  )
  (princ)
)

入力された名前を図面上に文字として配置するには、以下のような処理を追加できます:

掲載コード
(command "_.text" "j" "mc" (getpoint "\n配置位置を指定: ") 2.5 0 name)

これを progn の中に入れることで、入力された名前を図面に描画できます。こ

画面側の操作AutoLISP側で扱うこと
入力欄にkeyを付ける同じkeyを使ってタイルを指定する
利用者が値を入力するaction_tileで操作を受け、$valueで値を取得する
現在の入力を読み取るget_tileへkeyを渡す
OKまたはキャンセルで閉じるダイアログの終了状態に応じて後続の処理を決める

action_tile の基本説明

ここで初めて使ったaction_tileについて説明します。

action_tile は、DCLダイアログ内の各UI要素(ボタン、テキストボックスなど)に対して、ユーザーの操作に応じた処理をAutoLISP側で定義するための関数です。

この関数は、次のような構文で使用されます:

掲載コード
(action_tile "キー" "処理式")
  • キー はDCLファイルで定義されたUI要素の名前です。今回は”username”。
  • 処理式 は、ユーザーがそのUI要素を操作したときに実行されるAutoLISPコードです。

これにより、UIとAutoLISPのスクリプトを連携させることができます。

各行の役割と解説

  • (action_tile "username" "(setq name $value)") → DCL側で定義された edit_box のキー "username" に対応するアクションです。ユーザーが入力した文字列($value)をAutoLISP変数 name に代入します。
  • (action_tile "accept" "(done_dialog 1)") → OKボタンが押されたときに、done_dialog を呼び出してダイアログを終了します。戻り値として 1 が返されるため、後続の処理で「OKが押されたかどうか」を判定できます。
  • (action_tile "cancel" "(done_dialog 0)") → キャンセルボタンが押された場合の処理です。done_dialog に 0 を渡すことで、キャンセルされたことを示します。
  • (setq result (start_dialog)) → ダイアログを表示し、ユーザーの操作を待ちます。操作が完了すると、accept または cancel に応じた戻り値(1 または 0)が result に格納されます。
  • (unload_dialog dcl_id) → 使用したDCLダイアログをメモリから解放します。これにより、不要なリソースの消費を防ぎます。

まとめ

要素役割
keyDCL側の識別名(AutoLISPからアクセス)
action_tileタイルの値を取得・処理するための関数
$valueユーザーが入力した値(文字列)
start_dialogダイアログを表示し、ユーザー操作を待つ

この仕組みを理解すれば、複数の入力欄や選択肢を組み合わせた本格的なUI設計にも応用できます。

できたかどうか、ここで確認

画面で入力した値と、LISP側で受け取った値を同じかどうかを確認します。空欄・OK・キャンセルをそれぞれ試してください。

対象環境

AutoLISP対応環境(関数・OSごとの対応は要確認)。図形を変更する例は、コピーした図面で結果を確認してください。