UIオートメーション選択アイテムコントロールパターンの実装
手記
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、「Windows Automation API: UI オートメーション 」を参照してください。
このトピックでは、プロパティ、メソッド、イベントに関する情報など、ISelectionItemProviderを実装するためのガイドラインと規則について説明します。 概要の最後に、その他の参照へのリンクが一覧表示されます。
SelectionItemPattern コントロール パターンは、ISelectionProviderを実装するコンテナー コントロールの個別の選択可能な子項目として機能するコントロールをサポートするために使用されます。 SelectionItem コントロール パターンを実装するコントロールの例については、「UI オートメーション クライアントのコントロール パターン マッピング 」を参照してください。
実装のガイドラインと規則
選択項目コントロール パターンを実装する場合は、次のガイドラインと規則に注意してください。
- [表示プロパティ] ダイアログ ボックスの [画面の解像度] スライダーなど、IRawElementProviderFragmentRootを実装する子コントロールを管理する単一選択コントロールは、ISelectionProvider を実装する必要があり、その子は IRawElementProviderFragment と ISelectionItemProviderの両方を実装する必要があります。
ISelectionItemProvider の必須メンバー
ISelectionItemProviderの実装には、次のプロパティ、メソッド、およびイベントが必要です。
| 必須メンバー | メンバーの種類 | メモ |
|---|---|---|
| CanSelectMultiple | 財産 | None |
| IsSelectionRequired | 財産 | None |
| GetSelection | 方式 | None |
| InvalidatedEvent | 出来事 | コンテナー内の選択が大幅に変更され、InvalidateLimit 定数で許可されているよりも多くの ElementSelectedEvent イベントと ElementRemovedFromSelectionEvent イベントを送信する必要がある場合に発生します。 |
- Select、AddToSelection、または RemoveFromSelection の結果が選択された 1 つの項目である場合は、ElementSelectedEvent を発生させる必要があります。それ以外の場合は、必要に応じて ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent を送信します。
例外
プロバイダーは、次の例外をスローする必要があります。
| 例外の種類 | 条件 |
|---|---|
| InvalidOperationException | 次のいずれかが試行された場合: - RemoveFromSelection は、IsSelectionRequiredProperty = true 要素が既に選択されている単一選択コンテナーで呼び出されます。- RemoveFromSelection は、IsSelectionRequiredProperty = true され、1 つの要素のみが選択されている複数選択コンテナーで呼び出されます。- AddToSelection は、CanSelectMultipleProperty = false と別の要素が既に選択されている単一選択コンテナーで呼び出されます。 |