次の方法で共有


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

Note

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

このトピックでは、 IWindowProviderのプロパティ、メソッド、イベントに関する情報など、 WindowPattern の実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、トピックの最後に記載します。

WindowPattern コントロール パターンは、従来のグラフィカル ユーザー インターフェイス (GUI) 内で、ウィンドウベースの基本的な機能を提供するコントロールをサポートするために使用されます。 このコントロール パターンを実装する必要があるコントロールの例として、最上位のアプリケーション ウィンドウ、マルチドキュメント インターフェイス (MDI) 子ウィンドウ、サイズ変更可能な分割ペイン コントロール、モーダル ダイアログ ボックス、バルーン ヘルプ ウィンドウがあります。

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

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

  • UI オートメーションを使用してウィンドウのサイズと位置の両方を変更する機能をサポートするには、コントロールが ITransformProvider に加えて IWindowProviderを実装する必要があります。

  • コントロールを移動、サイズ変更、最大化、最小化、および閉じられるようにするタイトル バーの要素とタイトル バーを格納するコントロールは、通常 IWindowProviderを実装することが求められます。

  • ツールヒントのポップアップやコンボ ボックス、またはメニューのドロップダウンなどのコントロールは、通常 IWindowProviderを実装しません。

  • バルーン ヘルプ ウィンドウは、ウィンドウと同様の閉じるボタンを提供することで、基本的なツールヒント ポップアップから区別されます。

  • 全画面表示モードは、アプリケーション固有の機能であり、通常のウィンドウの動作ではないため、IWindowProvider によってサポートされません。

IWindowProvider の必須メンバー

IWindowProvider インターフェイスには、次のプロパティ、メソッド、イベントが必要です。

必須メンバー メンバーの型 メモ
InteractionState プロパティ なし
IsModal プロパティ なし
IsTopmost プロパティ なし
Maximizable プロパティ なし
Minimizable プロパティ なし
VisualState プロパティ なし
Close 方法 なし
SetVisualState 方法 なし
WaitForInputIdle 方法 なし
WindowClosedEvent イベント なし
WindowOpenedEvent イベント なし
WindowInteractionState イベント ReadyForUserInteraction

例外

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

例外の種類 条件
InvalidOperationException SetVisualState

- 要求された動作がコントロールによってサポートされない場合。
ArgumentOutOfRangeException WaitForInputIdle

- パラメーターが有効な数値ではない場合。

関連項目