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