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

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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

従来のグラフィカルユーザーインターフェイス (GUI) 内で基本的なウィンドウベースの機能を提供するコントロールをサポートするために、WindowPattern コントロールパターンが使用されます。このコントロールパターンを実装する必要があるコントロールの例として、トップレベルのアプリケーションのウィンドウ、マルチドキュメントインターフェイス (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