モデル駆動型アプリのフォームとグリッド内のイベント
イベントはすべてのクライアント側コードを開始します。 モデル駆動型アプリでは、イベント発生時に実行されるように JavaScript ライブラリ (スクリプト Web リソース) 内の特定の機能を関連付けます。 この機能は [イベント ハンドラー] と呼ばれます。 各イベント ハンドラーは、単一の関数を JavaScript ライブラリおよび関数が渡されるパラメータに指定します。
イベント ハンドラーは UI を使用する一部のイベントにのみ関連付けることができます。 UIを通じて関連付けることができないイベントの場合、クライアントAPIは、そのようなイベントにイベント ハンドラーをアタッチするために使用できるメソッドを提供します。
UI を使用するイベントに対してイベント ハンドラー機能を追加または削除する
フォーム プロパティ ダイアログ ボックスの イベントハンドラ セクションを使用して、スクリプトをフォームや列のイベントに関連付けることができます。
一括編集フォーム
既定では、フォームが一括編集モードの場合、イベント ハンドラーは呼び出されません。
一括編集モードでイベント ハンドラーを有効にするには、フォーム XML を修正して、該当する event 要素を見つけ、BehaviorInBulkEditForm 属性を作成/設定して Enabled にします。 現在、これは OnLoad イベント のサポートのみです。
フォーム XML のカスタマイズの詳細については、カスタマイズ ファイルを編集するタイミング、フォームをカスタマイズする、フォーム XML スキーマを参照してください。
一括編集モードのフォームで、イベント ハンドラーが呼び出されるタイミングを判断するには、getFormType メソッドを使用します。
コードを使用するイベントに対してイベント ハンドラー機能を追加または削除する
UI経由で関連付けることができないイベントのイベント ハンドラーを追加および削除するには、次のメソッドを使用します。
| Events | イベント ハンドラー |
|---|---|
| 属性 OnChange | addOnChange および removeOnChange メソッド |
| フォーム OnLoad | formContext.ui addOnLoad および removeOnLoad メソッド |
| フォーム が読み込まれました | formContext.ui addLoaded および removeLoaded メソッド |
| フォーム データ OnLoad | formContext.data addOnLoad および removeOnLoad メソッド |
| フォーム OnSave | addOnSave および removeOnSave メソッド |
| 検索コントロール PreSearch | addPreSearch および removePreSearch メソッド |
| kbsearch コントロール OnResultOpened | addOnResultOpened および removeOnResultOpened メソッド |
| kbsearch コントロール OnSelection | addOnSelection および removeOnSelection メソッド |
| kbsearch コントロール PostSearch | addOnPostSearch および removeOnPostSearch メソッド |
重要
実行コンテキストは、コードを使用してセットする関数に最初のパラメーターとして自動的に渡されます。 詳細: クライアント API 実行コンテキスト
フォーム イベント パイプライン
各イベントに最大 50 個のイベント ハンドラーを定義することができます。 各イベント ハンドラーは、[フォーム プロパティ] ダイアログ ボックスの [イベント] タブの [イベント ハンドラー] セクションに表示されている順序で実行されます。 · · ·
setSharedVariable および getSharedVariable メソッドを使用して、イベント ハンドラー間の共通変数 (関数) を渡します。 実行コンテキスト getDepth メソッドを使用すると、あるイベント ハンドラーが他のイベント ハンドラーとの関係でどの順序で実行されるかを知ることができます。
関連記事
クライアント API オブジェクト モデルについて
クライアント API 実行コンテキスト
イベント (クライアント API 参照)
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。