UI オートメーション Window コントロールパターンの実装

[アーティクル]
08/09/2011

メモ
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。

ここでは、WindowPattern プロパティ、メソッド、イベントに関する情報など、IWindowProvider を実装するガイドラインと規則について説明します。追加参照へのリンクはトピックの最後に示します。

従来のgraphical user interface (GUI) 内で基本的なウィンドウベースの機能を提供するコントロールをサポートするために、WindowPattern コントロールパターンが使用されます。このコントロールパターンを実装する必要があるコントロールの例として、トップレベルのアプリケーションのウィンドウ、multiple-document interface (MDI) の子ウィンドウ、サイズ変更可能な分割ペインコントロール、モーダルダイアログ、バルーンヘルプのウィンドウなどがあります。

このトピックは、次のセクションで構成されています。

実装のガイドラインと規則
IWindowProvider の必須メンバー
例外
関連トピック

実装のガイドラインと規則

Window コントロールパターンを実装する場合は、次のガイドラインと規則に注意してください。

UI オートメーションを使用してウィンドウサイズと画面位置の両方を変更できるようにするには、コントロールは、IWindowProvider に加えて ITransformProvider を実装する必要があります。
コントロールを移動、サイズ変更、最大化、最小化、または閉じるためのタイトルバーとタイトルバー要素を含むコントロールでは、通常、IWindowProvider を実装する必要があります。
ツールヒントポップアップや、コンボボックスまたはメニュードロップダウンなどのコントロールは、通常、IWindowProvider を実装しません。
バルーンヘルプのウィンドウは、通常のウィンドウと同様の [閉じる] ボタンを提供することで、基本的なツールヒントポップアップと区別されます。
全画面表示モードは、アプリケーションの機能に固有であり、標準のウィンドウ動作ではないため、IWindowProvider ではサポートされません。

IWindowProvider の必須メンバー

以下のプロパティ、メソッド、およびイベントは、IWindowProvider インターフェイスに必須です。

必須メンバー	メンバー型	説明
InteractionState	プロパティ	なし
IsModal	プロパティ	なし
IsTopmost	プロパティ	なし
Maximizable	プロパティ	なし
Minimizable	プロパティ	なし
VisualState	プロパティ	なし
Close	メソッド	なし
SetVisualState	メソッド	なし
WaitForInputIdle	メソッド	なし
WindowClosedEvent	イベント	なし
WindowOpenedEvent	イベント	なし
WindowInteractionState	イベント	ReadyForUserInteraction であることは保証されていません。

例外

プロバイダーは次の例外をスローする必要があります。

例外の種類	状態
InvalidOperationException	SetVisualState 要求された動作をコントロールがサポートしていない。
ArgumentOutOfRangeException	WaitForInputIdle パラメーターが有効な数ではない。

InvalidOperationException

SetVisualState