setFocus

参照構文式で指定したフォームオブジェクトにキーボードフォーカスを設定します。

クライアントアプリケーションでのみ使用できます。

引数 param1 が省略されているか null の場合、setFocus はフォーカスをクリアします。フォームオブジェクトのいずれかに入力フォーカスがある場合は、フォーカスはそのオブジェクトから除かれます。オブジェクト内の編集中の部分は変更され、必要な場合はドキュメントに記録を残します。変更をコミットすると検証エラーが発生する場合、そのエラーが表示されます。どのフォームオブジェクトも入力フォーカスを持っていない場合、引数がゼロの setFocus は何もしません。

setFocus は、form:ready イベント、layout:ready イベントまたは initialize イベントで使用することはできません。

構文

Reference_Syntax.setFocus( OBJECT param ) 
Reference_Syntax.setFocus( STRING param ) (deprecated)

パラメーター

param

（オプション）フォームオブジェクトの完全修飾参照構文式を表す有効な文字列です。

戻り値

なし

適用先

モデル

オブジェクト

ホストモデル

hostPseudoModel

バージョン

XFA 2.6

XFA 2. 1（非推奨）

例

JavaScript

xfa.host.setFocus(xfa.form.form1.TextField1);

FormCalc

xfa.host.setFocus("xfa.form.form1.TextField1")