UI オートメーションコントロールパターンの概要

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

ここでは、Microsoft UI オートメーションコントロールパターンについて説明します。コントロールパターンは、コントロールの型や外観に関係なく、コントロールの機能を分類したり公開したりするための手段です。

UI オートメーションでは、共通のコントロール動作を表すコントロールパターンを使用します。たとえば、ボタンなどの呼び出し可能なコントロールには Invoke コントロールパターンを使用し、リストボックス、リストビュー、コンボボックスなどのスクロールバーを持つコントロールには Scroll コントロールパターンを使用します。各コントロールパターンがそれぞれ別個の機能を表すため、これらを組み合わせて、特定のコントロールでサポートされる機能の完全なセットを記述できます。

メモ :
集約コントロールは、親によって公開された機能のユーザーインターフェイス (UI) を提供する子コントロールで構築されたコントロールであり、その子に通常関連付けられているコントロールパターンをすべて実装する必要があります。一方で、これらの同じコントロールパターンを子コントロールで実装する必要はありません。

集約コントロールは、親によって公開された機能のユーザーインターフェイス (UI) を提供する子コントロールで構築されたコントロールであり、その子に通常関連付けられているコントロールパターンをすべて実装する必要があります。一方で、これらの同じコントロールパターンを子コントロールで実装する必要はありません。

このトピックには次のセクションが含まれています。

UI オートメーションコントロールパターンコンポーネント
UI オートメーションのプロバイダおよびクライアント
動的コントロールパターン
コントロールパターンクラスとインターフェイス
関連トピック

UI オートメーションコントロールパターンコンポーネント

コントロールパターンは、コントロールで使用できる個々の機能を定義するために必要なメソッド、プロパティ、イベント、およびリレーションシップをサポートします。

UI オートメーション要素とその親、子、兄弟との間のリレーションシップは、UI オートメーションツリー内の要素の構造を表します。
メソッドは、UI オートメーションクライアントがコントロールを操作できるようにします。
プロパティとイベントは、コントロールパターンの機能に関する情報と、コントロールの状態に関する情報を提供します。

コントロールパターンと UI の関係は、インターフェイスとコンポーネントオブジェクトモデル (COM) オブジェクトの関係に似ています。COM では、オブジェクトを照会してサポートされるインターフェイスを要求し、それらのインターフェイスを使用して機能にアクセスできます。UI オートメーションでは、UI オートメーションクライアントは、どのコントロールパターンがサポートされるかをコントロールに問い合わせた後、そのサポートされるコントロールパターンによって公開されるプロパティ、メソッド、イベント、および構造体を介して、コントロールと対話できます。たとえば、複数行エディットボックスでは、UI オートメーションプロバイダは、IScrollProvider を実装します。クライアントは、AutomationElement が ScrollPattern コントロールパターンをサポートすることを認識すると、そのコントロールパターンによって公開されたプロパティ、メソッド、およびイベントを使用して、コントロールの操作、またはコントロールに関する情報へのアクセスができます。

UI オートメーションのプロバイダおよびクライアント

UI オートメーションプロバイダは、コントロールでサポートされる特定の機能の適切な動作を公開するコントロールパターンを実装します。

UI オートメーションクライアントは、UI オートメーションコントロールパターンクラスのメソッドおよびプロパティにアクセスし、これらを使用して UI に関する情報を取得したり、UI を操作します。これらのコントロールパターンクラスは、System.Windows.Automation 名前空間にあります (たとえば InvokePattern や SelectionPattern など)。

クライアントは、AutomationElement メソッド (AutomationElement.GetCurrentPropertyValue、AutomationElement.GetCachedPropertyValue など) または共通言語ランタイム (CLR) アクセサを使用して、パターンの UI オートメーションプロパティにアクセスします。コントロールパターンには、それぞれ 1 つのフィールドメンバ (たとえば InvokePattern.Pattern や SelectionPattern.Pattern) があり、このフィールドメンバは、コントロールパターンを識別し、AutomationElement のそのパターンを取得するために GetCachedPattern または GetCurrentPattern にパラメータとして渡されます。

動的コントロールパターン

すべてのコントロールが、常に同じコントロールパターンセットをサポートしているわけではありません。コントロールパターンがサポートされていると見なされるのは、UI オートメーションクライアントがこれらを使用できる場合です。たとえば、複数行エディットボックスは、表示可能領域に表示できる量を超えるテキストの行が含まれている場合にのみ、垂直方向のスクロールを有効にします。テキストが削除されてスクロールする必要がなくなると、スクロールは無効になります。この例の場合、ScrollPattern コントロールパターンは、コントロールの現在の状態 (エディットボックス内のテキスト量) に応じて動的にサポートされています。

コントロールパターンクラスとインターフェイス

UI オートメーションコントロールパターンを次の表に示します。この表では、コントロールパターンにアクセスするために UI オートメーションクライアントが使用するクラス、およびコントロールパターンを実装する UI オートメーションプロバイダが使用するインターフェイスも示しています。

コントロールパターンクラス	プロバイダインターフェイス	説明
DockPattern	IDockProvider	ドッキングコンテナ内にドッキングできるコントロールに使用されます。たとえば、ツールバー、ツールパレットなどがあります。
ExpandCollapsePattern	IExpandCollapseProvider	展開または折りたたむことができるコントロールに使用されます。たとえば、[ファイル] メニューのような、アプリケーションのメニュー項目などです。
GridPattern	IGridProvider	指定したセルのサイズ設定や指定したセルへの移動など、グリッド機能をサポートするコントロールに使用されます。たとえば、Windows エクスプローラの大きいアイコン表示や、Microsoft Word のヘッダーがない単純なテーブルなどです。
GridItemPattern	IGridItemProvider	グリッド内にセルを持つコントロールに使用されます。個々のセルは、GridItem パターンをサポートする必要があります。たとえば、Microsoft Windows エクスプローラの詳細表示の各セルなどです。
InvokePattern	IInvokeProvider	ボタンなど、呼び出すことができるコントロールに使用されます。
MultipleViewPattern	IMultipleViewProvider	同じ情報セットの複数の表現、データ、または子の間で切り替えることができるコントロールに使用されます。たとえば、サムネイル、タイル、アイコン、リスト、または詳細の表示でデータを使用できるリストビューコントロールなどです。
RangeValuePattern	IRangeValueProvider	コントロールに適用できる値の範囲を持つコントロールに使用されます。たとえば、年を格納するスピンコントロールは 1900 ～ 2010 の範囲を持ち、月を表す別のスピンコントロールは 1 ～ 12 の範囲を持ちます。
ScrollPattern	IScrollProvider	スクロールできるコントロールに使用されます。たとえば、コントロールの表示可能領域に表示できる量を超える情報がある場合にアクティブになるスクロールバーを持つコントロールなどです。
ScrollItemPattern	IScrollItemProvider	スクロールされるリスト内に個々の項目を持つコントロールに使用されます。たとえば、コンボボックスコントロールのような、スクロールリスト内に個々の項目を持つリストコントロールなどです。
SelectionPattern	ISelectionProvider	選択コンテナコントロールに使用されます。たとえば、リストボックス、コンボボックスなどです。
SelectionItemPattern	ISelectionItemProvider	リストボックスやコンボボックスなどの選択コンテナコントロール内の個々の項目に使用されます。
TablePattern	ITableProvider	グリッドおよびヘッダー情報を持つコントロールに使用されます。たとえば、Microsoft Excel ワークシートなどです。
TableItemPattern	ITableItemProvider	テーブル内の項目に使用されます。
TextPattern	ITextProvider	エディットコントロールと、テキスト情報を公開するドキュメントに使用されます。
TogglePattern	IToggleProvider	状態を切り替えることができるコントロールに使用されます。たとえば、チェックボックス、チェック可能なメニュー項目などです。
TransformPattern	ITransformProvider	サイズ変更、移動、および回転できるコントロールに使用されます。Transform コントロールパターンは、デザイナ、フォーム、グラフィカルエディタ、および描画アプリケーション内で使用されるのが一般的です。
ValuePattern	IValueProvider	値の範囲をサポートしていないコントロールでクライアントが値を取得または設定できるようにします。たとえば、日付指定などです。
WindowPattern	IWindowProvider	ウィンドウに固有の情報、すなわち、Microsoft Windows オペレーティングシステムの基本概念を公開します。ウィンドウであるコントロールの例として、トップレベルのアプリケーションウィンドウ (Microsoft Word、Microsoft Windows エクスプローラなど)、マルチドキュメントインターフェイス (MDI) の子ウィンドウ、ダイアログなどがあります。