クライアント API グリッド コンテキスト

グリッドではデータを表形式で表示します。 グリッドは、フォーム全体にまたがることも、フォーム上のアイテムの 1 つになることもできます。後者はサブグリッドと呼ばれます。

クライアント API グリッドコンテキストオブジェクトは、現在のコードが実行されるフォームのサブグリッドへの参照を提供します。

formContext オブジェクトを使用して、コードが実行される場所のフォームのインスタンスを取得してから、フォーム上のサブグリッド コントロールを取り込みます。 たとえば、サブグリッド コントロールの名前を認識しているとき(例として、既定の取引先企業フォーム内の取引先担当者サブグリッド)、次のコードを使用してそのコントロールにアクセスできます。

function doSomething(executionContext) {
   var formContext = executionContext.getFormContext(); // get the form Context
   var gridContext = formContext.getControl("Contacts"); // get the grid context

   // Perform operations on the subgrid
}

制限事項

• グリッドのコンテキストの取得 (フォーム全体に渡る) はリボン コマンドでのみサポートされます。 詳細情報 リボン アクションのフォームとグリッドのコンテキスト
• gridContext を使用する場合、getControl() の呼び出しはサポートされません。
• グリッド コンテキストは、実行コンテキストと同じ有効性を持ちます。 実行コンテキストのイベント ハンドラーが終了すると、これらのコンテキストを使用するには特別な注意が必要です。 コンテキスト オブジェクトの非同期的な使用を参照してください

関連記事

クライアントAPIフォームコンテキスト
クライアント API 実行コンテキスト
クライアント API オブジェクト モデルについて
グリッドおよびサブグリッド