クライアント 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
}
制限
- グリッドのコンテキストの取得 (フォーム全体に渡る) はリボン コマンドでのみサポートされます。 詳細情報 リボン アクションのフォームとグリッドのコンテキスト
- を使用する場合、
getControl()
への呼び出しはサポートされませんgridContext
。 - グリッド コンテキストは、実行コンテキストと同じ有効性を持ちます。 実行コンテキストのイベント ハンドラーが終了したら、これらのコンテキストを使用するには特別な注意が必要です。 コンテキストオブジェクトを非同期的に使用する を参照してください。
関連記事
クライアント API フォーム コンテキスト
クライアント API 実行コンテキスト
クライアント API オブジェクト モデルについて
グリッドおよびサブグリッド
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。