GridAttribute (クライアント API 参照)
GridAttribute は、読み取り専用グリッドと編集可能グリッドの両方でサポートされています。
GridAttribute は、編集可能なグリッドのセル内のデータを表し、列に関連付けられているすべてのセルへの参照が含まれています。 コレクション内のデータにアクセスするために使用できるメソッドの詳細については、「コレクション (クライアント API 参照)」を参照してください。
GridAttribute は、選択されたグリッド行の列に対する コントロール コレクションもサポートしており、列に関連付けられたセルのコレクションを操作するメソッドを提供しています。 選択されたグリッド行の各セル (GridCell) は、編集可能なグリッドの列に関連付けられたフォーム上のコントロールに類似しています。 コレクション内のデータにアクセスするために使用できるメソッドの詳細については、「コレクション (クライアント API 参照)」を参照してください。
チップ
パフォーマンス上の理由のため、編集可能なグリッドの行 (レコード) はレコードが選択されるまで編集できません。 ユーザーはグリッド内で単一レコードを選択して編集する必要があります。 編集可能なグリッドでレコードが選択されると、Dynamics 365 は、レコードへのユーザーアクセス、レコードがアクティブかどうか、列の検証などを内部的に評価し、データの編集時にデータのセキュリティと有効性を守ります。 編集可能な状態にあるグリッド内のレコードにアクセスするために、getFormContext メソッドで OnRecordSelect イベントを使用することを検討してください。
メソッド
GridAttribute は、選択したグリッド行の列に対して次のメソッドをサポートします。
| 件名 | 内容 |
|---|---|
| getName | 選択されたグリッドの行の列の論理名を返します。 |
| getRequiredLevel | 列の値が必須であるか推奨であるかを示す文字列値を返します。 |
| setRequiredLevel | レコードを保存する前に、選択したグリッドの行の列にデータを必要とするか、推奨するかを設定します。 |
| getValue | 列のデータ値を取得します。 |
| setValue | 列のデータ値を設定します。 |
ヒント
編集可能グリッドの行を選択するには、Grid.getSelectedRows を使用します。