UI オートメーション SelectionItem コントロール パターンの実装
メモ |
---|
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。 |
ここでは、プロパティ、メソッド、イベントに関する情報など、ISelectionItemProvider を実装するガイドラインと規則について説明します。 追加参照へのリンクは概要の最後に示します。
SelectionItemPattern コントロール パターンは、ISelectionProvider を実装するコンテナー コントロールの、独立した選択可能な子項目として機能するコントロールをサポートするために使用します。 SelectionItem コントロール パターンを実装するコントロールの例については、「UI オートメーション クライアントのコントロール パターン マッピング」を参照してください。
このトピックは、次のセクションで構成されています。
- 実装のガイドラインと規則
- ISelectionItemProvider の必須メンバー
- 例外
- 関連トピック
実装のガイドラインと規則
Selection Item コントロール パターンを実装するときは、次のガイドラインと規則に注意してください。
- 子コントロールを管理し、IRawElementProviderFragmentRoot を実装する単一選択コントロール (たとえば [画面のプロパティ] ダイアログ ボックスの [画面の解像度] スライダー) は、ISelectionProvider を実装し、その子は IRawElementProviderFragment と ISelectionItemProvider の両方を実装します。
ISelectionItemProvider の必須メンバー
以下のプロパティ、メソッド、およびイベントは、ISelectionItemProvider の実装時に必要です。
必須メンバー |
メンバー型 |
説明 |
---|---|---|
プロパティ |
なし |
|
プロパティ |
なし |
|
メソッド |
なし |
|
イベント |
コンテナー内の選択内容が大幅に変更された結果、送信される ElementSelectedEvent イベントおよび ElementRemovedFromSelectionEvent イベントの数が InvalidateLimit 定数による制限を超える場合に発生します。 |
- Select、AddToSelection、または RemoveFromSelection の結果、選択項目が 1 つだけになった場合は、ElementSelectedEvent を発生させます。それ以外の場合は、状況に応じて ElementAddedToSelectionEvent または ElementRemovedFromSelectionEvent を送信します。
例外
プロバイダーは次の例外をスローする必要があります。
例外の種類 |
状態 |
---|---|
次のいずれかが試行されたとき
|
参照
処理手順
UI オートメーション プロバイダーでのコントロール パターンのサポート
概念
クライアントの UI オートメーション コントロール パターン