モデル駆動型アプリにおけるグリッドおよびサブグリッド (クライアント API 参照)

グリッドとサブグリッドは、モデル駆動型アプリの表形式でデータを表示します。 この記事のクライアント API イベントとオブジェクトを使用して、読み取り専用および編集可能なグリッドを操作します。 グリッドは、フォーム全体にまたがることも、フォーム上のアイテムの 1 つになることもできます。後者は サブグリッド と呼ばれます。

グリッドの種類

モデル駆動型アプリのグリッドには 2 種類あります。

  • 読み取り専用グリッド: 表形式でデータを表示します。 読み取り専用のグリッドに表示されているデータを編集するには、グリッド内のレコードを選択してフォームを開き、データを編集してから保存する必要があります。
  • 編集可能グリッド: データを表形式で表示するだけでなく、Web クライアントやモバイル クライアントで、レコードやビューを切り替える必要がないように、同じグリッド内のデータをグループ化、並べ替え、フィルター処理する機能など、豊富なインライン編集機能を提供します。 編集可能グリッドは、カスタム コントロールであり、Web クライアントおよびダッシュボードのフォームでのメイン グリッドやサブグリッド、およびモバイル クライアントでのフォーム グリッドでサポートされます。 編集可能グリッド コントロールでは編集機能を提供しますが、読み取り専用グリッド メターデータおよびフィールドレベルのセキュリティ設定に従います。

グリッド コンテキストを取得する

グリッド コンテキストは、コードを実行する対象であるフォーム上のグリッドまたはサブグリッドのインスタンスです。 JavaScript コードを実行するためのグリッド コンテキストの取得の詳細については、「 クライアント API グリッド コンテキスト」を参照してください。

グリッド イベント

Name 内容 次に適用可能
サブグリッド OnLoad イベント サブグリッドが更新されるたびに発生します。 このイベントには、ユーザーが列見出しをクリックしてサブグリッドの値を並べ替える場合が含まれます。 読み取り専用グリッド
グリッド OnChange 編集可能なグリッドのセルで値が変更されているとき、またはセルがフォーカスを失ったときに発生します 編集可能なグリッド
グリッド OnRecordSelect 単一の行 (レコード) が編集可能なグリッドで選択されている場合に発生します 編集可能なグリッド
グリッド OnSave 更新された情報をサーバーに送信する前に発生します。レコードの選択に変更があった場合、ユーザーは編集可能グリッドの保存ボタンを使用して保存操作を明示的にトリガーするか、保留中の変更がある間に編集可能グリッドから並べ替え、フィルター、グループ、改ページ、またはナビゲーション操作を適用します。 編集可能なグリッド

ヒント

テーブルまたは読み取り専用グリッドの編集可能グリッドを有効にするために使用するモデル駆動型アプリ ページの [イベント] タブを使用して、OnChange、OnRecordSelect、OnSave イベントに登録できます。

Grid オブジェクト

次のオブジェクトを使用して、グリッドを操作します。 これらのオブジェクトは、次の図に示すように階層を形成します。

グリッドとサブグリッドで使用できるクライアント API オブジェクトの階層のスクリーンショット。

Name 内容 以下に使用できます
GridControl グリッドまたはサブグリッド コントロールを操作するためのメソッドを提供します。 読み取り専用および編集可能なグリッド
Grid グリッドのデータに関する情報にアクセスするためのメソッドを提供します。 読み取り専用および編集可能なグリッド
GridRow グリッドの行または選択した行を操作するためのメソッドを提供します。 読み取り専用および編集可能なグリッド
GridRowData グリッドの行または選択した行を操作するためのメソッドを提供します。 読み取り専用および編集可能なグリッド
GridEntity 行内の特定のレコードに関するデータにアクセスするためのメソッドを提供します。 読み取り専用および編集可能なグリッド
GridAttribute 編集可能なグリッドのセルのデータにアクセスするためのメソッドを提供します。 編集可能なグリッド
GridCell 編集可能なグリッドの列に関連付けられているフォームのコントロールに関連するデータにアクセスするメソッドを提供します。 編集可能なグリッド
ViewSelector サブグリッド コントロールのビュー セレクターに関する情報を取得または設定するメソッドを提供します。 読み取り専用グリッド

クライアントAPIグリッドコンテキスト
編集可能グリッドの使用
モデル駆動型アプリのクライアント API リファレンス
モデル駆動型アプリ開発者ガイド