グリッド コントロール パターン
プロパティとメソッドに関する情報など、IGridProvider実装するためのガイドラインと規則について説明します。 Grid コントロール パターンは、子要素のコレクションのコンテナーとして機能するコントロールをサポートするために使用されます。
この要素の子は、IGridItemProvider を実装し、行と列で走査できる 2 次元の論理座標系で編成する必要があります。 このコントロール パターンを実装するコントロールの例については、「コントロールの種類とサポートされるコントロール パターンの」を参照してください。
このトピックには、次のセクションが含まれています。
- 実装ガイドラインと規則
- IGridProviderに必要なメンバーを する
- 関連トピック
実装のガイドラインと規則
Grid コントロール パターンを実装する場合は、次のガイドラインと規則に注意してください。
グリッド座標は、座標 (0,0) を持つ左上 (またはロケールに応じて右上のセル) で 0 から始まります。
セルが空の場合でも、そのセルの IGridItemProvider::ContainingGrid プロパティをサポートするために、Microsoft UI オートメーション要素を返す必要があります。 これは、グリッド内の子要素のレイアウトが不規則な配列に似ている場合に可能です (下の例を参照)。
論理的にグリッドと見なされる場合、IGridProvider実装するには、項目が 1 つのグリッドが必要です。 グリッド内の子項目の数は重要ではありません。
プロバイダーの実装に応じて、非表示の行と列が UI オートメーション ツリーに読み込まれる可能性があるため、IGridProvider::RowCount および ColumnCount プロパティに反映されます。 非表示の行と列がまだ読み込まれていない場合は、カウントしないでください。
IGridProviderでは、グリッドのアクティブな操作は有効になりません。この機能を有効にするには、ITransformProvider実装する必要があります。
IUIAutomationStructureChangedEventHandler を使用して、追加、削除、結合されたセルなどのグリッドの構造またはレイアウトの変更をリッスンします。
IUIAutomationFocusChangedEventHandler を使用して、グリッドの項目またはセルのトラバーサルを追跡します。
IGridProvider に必要なメンバー
IGridProvider インターフェイスを実装する場合は、次のプロパティとメソッドが必要です。
| 必須メンバー | メンバーの種類 | 筆記 |
|---|---|---|
| RowCount | 財産 | 何一つ |
| ColumnCount | 財産 | 何一つ |
| GetItemをする | 方式 | 何一つ |
このコントロール パターンには、関連付けられたイベントはありません。
関連トピック