グリッドとサブグリッドは、モデル駆動型アプリの表形式でデータを表示します。 この記事のクライアント API イベントとオブジェクトを使用して、読み取り専用および編集可能なグリッドを操作します。 グリッドは、フォーム全体にまたがることも、フォーム上のアイテムの 1 つになることもできます。後者は サブグリッド と呼ばれます。
グリッドの種類
モデル駆動型アプリのグリッドには 2 種類あります。
- 読み取り専用グリッド: 表形式でデータを表示します。 読み取り専用のグリッドに表示されているデータを編集するには、グリッド内のレコードを選択してフォームを開き、データを編集してから保存する必要があります。
- 編集可能グリッド: データを表形式で表示するだけでなく、Web クライアントやモバイル クライアントで、レコードやビューを切り替える必要がないように、同じグリッド内のデータをグループ化、並べ替え、フィルター処理する機能など、豊富なインライン編集機能を提供します。 編集可能グリッドは、カスタム コントロールであり、Web クライアントおよびダッシュボードのフォームでのメイン グリッドやサブグリッド、およびモバイル クライアントでのフォーム グリッドでサポートされます。 編集可能グリッド コントロールでは編集機能を提供しますが、読み取り専用グリッド メターデータおよびフィールドレベルのセキュリティ設定に従います。
グリッド コンテキストを取得する
グリッド コンテキストは、コードを実行する対象であるフォーム上のグリッドまたはサブグリッドのインスタンスです。 JavaScript コードを実行するためのグリッド コンテキストの取得の詳細については、「 クライアント API グリッド コンテキスト」を参照してください。
グリッド イベント
| Name | 内容 | 次に適用可能 |
|---|---|---|
| サブグリッド OnLoad イベント | サブグリッドが更新されるたびに発生します。 このイベントには、ユーザーが列見出しをクリックしてサブグリッドの値を並べ替える場合が含まれます。 | 読み取り専用グリッド |
| グリッド OnChange | 編集可能なグリッドのセルで値が変更されているとき、またはセルがフォーカスを失ったときに発生します | 編集可能なグリッド |
| グリッド OnRecordSelect | 単一の行 (レコード) が編集可能なグリッドで選択されている場合に発生します | 編集可能なグリッド |
| グリッド OnSave | 更新された情報をサーバーに送信する前に発生します。レコードの選択に変更があった場合、ユーザーは編集可能グリッドの保存ボタンを使用して保存操作を明示的にトリガーするか、保留中の変更がある間に編集可能グリッドから並べ替え、フィルター、グループ、改ページ、またはナビゲーション操作を適用します。 | 編集可能なグリッド |
ヒント
テーブルまたは読み取り専用グリッドの編集可能グリッドを有効にするために使用するモデル駆動型アプリ ページの [イベント] タブを使用して、OnChange、OnRecordSelect、OnSave イベントに登録できます。
Grid オブジェクト
次のオブジェクトを使用して、グリッドを操作します。 これらのオブジェクトは、次の図に示すように階層を形成します。
| Name | 内容 | 以下に使用できます |
|---|---|---|
| GridControl | グリッドまたはサブグリッド コントロールを操作するためのメソッドを提供します。 | 読み取り専用および編集可能なグリッド |
| Grid | グリッドのデータに関する情報にアクセスするためのメソッドを提供します。 | 読み取り専用および編集可能なグリッド |
| GridRow | グリッドの行または選択した行を操作するためのメソッドを提供します。 | 読み取り専用および編集可能なグリッド |
| GridRowData | グリッドの行または選択した行を操作するためのメソッドを提供します。 | 読み取り専用および編集可能なグリッド |
| GridEntity | 行内の特定のレコードに関するデータにアクセスするためのメソッドを提供します。 | 読み取り専用および編集可能なグリッド |
| GridAttribute | 編集可能なグリッドのセルのデータにアクセスするためのメソッドを提供します。 | 編集可能なグリッド |
| GridCell | 編集可能なグリッドの列に関連付けられているフォームのコントロールに関連するデータにアクセスするメソッドを提供します。 | 編集可能なグリッド |
| ViewSelector | サブグリッド コントロールのビュー セレクターに関する情報を取得または設定するメソッドを提供します。 | 読み取り専用グリッド |
関連記事
クライアントAPIグリッドコンテキスト
編集可能グリッドの使用
モデル駆動型アプリのクライアント API リファレンス
モデル駆動型アプリ開発者ガイド