getVar

フォームスクリプトから、LucyStudioデザイナーに**あらかじめ定義されたフォーム変数（Form Var）**の現在の値を読み取ります。

パラメータ

localVarName（string）: LucyStudioのフォーム設定であらかじめ定義された変数名

戻り値: any — 変数の現在の値。定義されていない変数名の場合はnullを返します

説明

$form.getVarは、LucyStudioデザイナーでフォーム単位にあらかじめ定義された変数の値を読み取ります。内部ではLucyVarMngr.getVarValue(_mapFormVar, localVarName)を呼び出します。

変数は現在のフォームインスタンスにのみ有効で、他のフォームインスタンスの変数にはアクセスできません。

警告

変数名はLucyStudioデザイナーであらかじめ定義されている必要があります。定義されていない変数名はnullを返します。

$form・$app・$pageの比較

区分	`$form.getVar`	`$app.getVar`	`$page.getVar`
スコープ	現在のフォームインスタンス	アプリ全体で共有	❌ 未対応
事前定義の場所	LucyStudioのフォーム設定	LucyStudioのアプリ設定	—
ライフサイクル	フォームが閉じられると破棄	アプリ実行中は保持	—
他のフォームからのアクセス	❌ 不可	✅ 可能	—

Example

// 폼 변수 읽기
var count = $form.getVar("count");
$log.i("현재 카운트:", count);

var user = $form.getVar("selectedUser");
if (user !== null) {
  $log.i("선택된 사용자:", user.name);
} else {
  $log.i("선택된 사용자 없음");
}

getVar​

getVar