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