次の方法で共有


UI オートメーションと Microsoft Active Accessibility

Note

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

Microsoft Active Accessibility は、アプリケーションをアクセス可能にするための以前のソリューションでした。 Microsoft UI オートメーションは Microsoft Windows の新しいアクセシビリティ モデルであり、その目的は支援技術製品と自動テスト ツールのニーズを解決することです。 UI オートメーションは、多くの点で Active Accessibility よりも強化されています。

このトピックでは、UI オートメーションの主な機能を紹介し、Active Accessibility との違いについて説明します。

プログラミング言語

Active Accessibility は、デュアル インターフェイスをサポートするコンポーネント オブジェクト モデル (COM) に基づいているため、C/C++、Microsoft Visual Basic 6.0、およびスクリプト言語でプログラミングできます。 UI オートメーション (標準コントロールのクライアント側プロバイダー ライブラリを含む) はマネージド コードで記述されており、C# または Visual Basic .NET を使用して UI オートメーション クライアント アプリケーションを実に簡単にプログラムすることができます。 インターフェイスを実装する UI オートメーション プロバイダーは、マネージド コードまたは C/C++ で記述できます。

Windows Presentation Foundation におけるサポート

Windows Presentation Foundation (WPF) は、ユーザー インターフェイスを作成するための新しいモデルです。 WPF の要素には Active Accessibility のネイティブ サポート機能はありませんが、UI オートメーションがサポートされており、これに Active Accessibility クライアントのためのブリッジ サポートが含まれています。 UI オートメーション専用に作成されたクライアントだけが WPF のユーザー補助機能 (テキストに関する豊富なサポートなど) を最大限に利用できます。

サーバーとクライアント

Active Accessibility では、サーバーとクライアントは、主にサーバーによる IAccessible の実装を介して直接通信します。

UI オートメーションでは、サーバー (プロバイダー) とクライアントの間にコア サービスが存在します。 このコア サービスは、プロバイダーによって実装されたインターフェイスを呼び出して、追加のサービス (要素の一意のランタイム識別子の生成など) を提供します。 クライアント アプリケーションはライブラリ関数を使用して UI オートメーション サービスを呼び出します。

UI オートメーション プロバイダーは Active Accessibility クライアントに情報を提供でき、Active Accessibility サーバーは UI オートメーション クライアント アプリケーションに情報を提供できます。 ただし、Active Accessibility は UI オートメーションほど多くの情報を公開しないため、この 2 つのモデルには完全な互換性がありません。

UI 要素

Active Accessibility では UI 要素を IAccessible インターフェイスまたは子識別子として表現します。 2 つの IAccessible ポインターを比較してそれらが同じ要素を参照しているかどうかを判断するのは困難です。

UI オートメーションでは、すべての要素が AutomationElement オブジェクトとして表現されます。 比較は等値演算子または Equals メソッドを使用して行われますが、どちらの方法でも、要素の一意のランタイム識別子が比較されます。

ツリー ビューとナビゲーション

画面上の UI インターフェイス (UI) 要素は、ツリー構造で表すことができます。デスクトップがルートで、その直接の子としてアプリケーション ウィンドウがあり、アプリケーション内の要素がその子孫となります。

Active Accessibility では、エンドユーザーには無関係なオートメーション要素も多数、ツリー内に公開されます。 クライアント アプリケーションは、すべての要素の中から意味のあるものを特定する必要があります。

UI オートメーション クライアント アプリケーションは、フィルタリングしたビューを使用して UI を確認します。 このビューには、必要な要素 (ユーザーに情報を提供したり、対話を可能にしたりする要素) のみが表示されます。 コントロール要素だけが含まれるビューや、コンテンツ要素だけが含まれるビューがあらかじめ定義されています。さらに、アプリケーションでカスタム ビューを定義することもできます。 UI オートメーションは、ユーザーに対して UI を簡単に表せるようにして、ユーザーとアプリケーションの対話を支援します。

Active Accessibility における要素間ナビゲーションは、空間的 (画面上で左にある要素に移動するなど)、論理的 (次のメニュー項目に移動する、ダイアログ ボックスのタブ オーダー内で次の項目に移動するなど)、階層的 (コンテナー内の最初の子に移動する、子からその親に移動するなど) のいずれかです。 子要素が IAccessibleを実装しているオブジェクトであるとは限らないため、階層的ナビゲーションは複雑です。

UI オートメーションでは、すべての UI 要素が、同じ基本機能をサポートする AutomationElement オブジェクトです。 (プロバイダーの観点では、IRawElementProviderSimple から継承されたインターフェイスを実装するオブジェクトです)。ナビゲーションは主に階層的 (親から子、兄弟から次の兄弟) です (兄弟間のナビゲーションは、タブ オーダーに従う場合があるため、論理的要素も持っています)。フィルタリングされたツリー ビューで TreeWalker クラスを使用して、任意の場所からナビゲーションを開始できます。 FindFirstFindAllを使用して、特定の子または子孫に移動することもできます。たとえば、指定したコントロール パターンがサポートされるダイアログ ボックス内のすべての要素を非常に簡単に取得できます。

UI オートメーションにおけるナビゲーションは、Active Accessibility の場合より一貫性があります。 ドロップダウン リストやポップアップ ウィンドウなど、Active Accessibility ツリーに 2 回表示される要素がありますが、このような要素からナビゲーションすると、予期しない結果が生じる可能性があります。 実際には、rebar コントロールに対して Active Accessibility を正しく実装することは不可能です。 UI オートメーションでは親の再指定や位置変更が可能なため、ウィンドウの所有関係による階層にかかわらず、要素をツリー内の任意の場所に配置できます。

役割とコントロール型

Active Accessibility は、accRole プロパティ (IAccessible::get_actRole) を使用して、ROLE_SYSTEM_SLIDER や ROLE_SYSTEM_MENUITEM などの UI 内の要素の役割の記述を取得します。 要素の役割は、要素の機能を表す主要な鍵になります。 コントロールとの対話は、 IAccessible::accSelectIAccessible::accDoDefaultActionなどの固定のメソッドを使用して実現されます。 クライアント アプリケーションと UI の間の対話は、IAccessible を通して実行できる範囲に限定されます。

これに対して、UI オートメーションでは、要素のコントロール型 (ControlType プロパティで記述) と、それに期待される機能とが大きく分離されています。 機能は、特殊なインターフェイスの実装を通じてプロバイダーによってサポートされる、コントロール パターンによって決定されます。 複数のコントロール パターンを組み合わせると、特定の UI 要素がサポートする機能をすべて記述することができます。 プロバイダーによっては、ある 1 つの特定のコントロール パターンをサポートしなければならないものがあります。たとえば、チェック ボックスのプロバイダーは Toggle コントロール パターンをサポートする必要があります。 また、コントロール パターンのセットを 1 つ以上サポートしなければならないものもあります。たとえば、ボタンは、Toggle と Invoke のいずれかをサポートする必要があります。 さらに、コントロール パターンをまったくサポートしないものもあります。たとえば、移動もサイズ変更もドッキングもできないペインには、コントロール パターンはありません。

UI オートメーションは、Custom プロパティによって識別され、LocalizedControlTypeProperty プロパティによって記述可能なカスタム コントロールをサポートします。

次の表に、Active Accessibility の役割と UI オートメーションのコントロール型のマッピングを示します。

Active Accessibility の役割 UI オートメーション コントロール型
ROLE_SYSTEM_PUSHBUTTON ボタン
ROLE_SYSTEM_CLIENT Calendar
ROLE_SYSTEM_CHECKBUTTON チェック ボックス
ROLE_SYSTEM_COMBOBOX コンボ ボックス
ROLE_SYSTEM_CLIENT Custom
ROLE_SYSTEM_LIST データ グリッド
ROLE_SYSTEM_LISTITEM データ アイテム
ROLE_SYSTEM_DOCUMENT ドキュメント
ROLE_SYSTEM_TEXT [編集]
ROLE_SYSTEM_GROUPING Group
ROLE_SYSTEM_LIST ヘッダー
ROLE_SYSTEM_COLUMNHEADER ヘッダー項目
ROLE_SYSTEM_LINK ハイパーリンク
ROLE_SYSTEM_GRAPHIC Image
ROLE_SYSTEM_LIST List
ROLE_SYSTEM_LISTITEM リスト項目
ROLE_SYSTEM_MENUPOPUP メニュー
ROLE_SYSTEM_MENUBAR メニュー バー
ROLE_SYSTEM_MENUITEM メニュー項目
ROLE_SYSTEM_PANE ペイン
ROLE_SYSTEM_PROGRESSBAR 進行状況バー
ROLE_SYSTEM_RADIOBUTTON ラジオ ボタン
ROLE_SYSTEM_SCROLLBAR スクロール バー
ROLE_SYSTEM_SEPARATOR 区切り記号
ROLE_SYSTEM_SLIDER スライダー
ROLE_SYSTEM_SPINBUTTON Spinner
ROLE_SYSTEM_SPLITBUTTON 分割ボタン
ROLE_SYSTEM_STATUSBAR ステータス バー
ROLE_SYSTEM_PAGETABLIST タブ
ROLE_SYSTEM_PAGETAB タブ項目
ROLE_SYSTEM_TABLE テーブル
ROLE_SYSTEM_STATICTEXT テキスト
ROLE_SYSTEM_INDICATOR つまみ
ROLE_SYSTEM_TITLEBAR タイトル バー
ROLE_SYSTEM_TOOLBAR ツール バー
ROLE_SYSTEM_TOOLTIP ToolTip
ROLE_SYSTEM_OUTLINE ツリー
ROLE_SYSTEM_OUTLINEITEM ツリー項目
ROLE_SYSTEM_WINDOW ウィンドウ

さまざまなコントロール型の詳細については、「 UI Automation Control Types」を参照してください。

状態とプロパティ

Active Accessibility では、要素は一般的なプロパティのセットをサポートします。一部のプロパティ (accState など) は、要素の役割に応じてまったく異なる内容を記述する必要があります。 サーバーは、プロパティを返す IAccessible のメソッドをすべて (要素に無関係なものも含む) 実装する必要があります。

UI オートメーションでは、さらに多くのプロパティが定義されており、その一部は Active Accessibility での状態に対応します。 すべての要素に共通するものもあれば、コントロール型とコントロール パターンに固有のものもあります。 プロパティは一意の識別子によって識別され、ほとんどのプロパティは単一のメソッド ( GetCurrentPropertyValue または GetCachedPropertyValue) を使用して取得できます。 多くのプロパティは、 Current プロパティ アクセサーおよび Cached プロパティ アクセサーからも容易に取得できます。

UI オートメーション プロバイダーは、無関係なプロパティを実装する必要はなく、サポートしていないプロパティに対しては単に null 値を返すことができます。 また、UI オートメーションのコア サービスは、一部のプロパティを既定のウィンドウ プロバイダーから取得できます。これらは、プロバイダーによって明示的に実装されたプロパティと 1 つにまとめられます。

UI オートメーションでは、多くのプロパティをサポートすることに加えて、単一のプロセス間呼び出しで複数のプロパティを取得できるので、パフォーマンスが向上します。

次の表に、2 つのモデルのプロパティ間の対応を示します。

Active Accessibility プロパティ アクセサー UI オートメーションのプロパティ ID 解説
get_accKeyboardShortcut AccessKeyProperty または AcceleratorKeyProperty 両方とも存在する場合はAccessKeyProperty が優先されます。
get_accName NameProperty
get_accRole ControlTypeProperty 役割とコントロール型のマッピングについては、前の表を参照してください。
get_accValue ValuePattern.ValueProperty

RangeValuePattern.ValueProperty
ValuePattern または RangeValuePattern をサポートするコントロール型でのみ有効です。 MSAA 動作との一貫性を保つために、RangeValue 値は 0 ~ 100 に正規化されます。 Value 項目は文字列を使用します。
get_accHelp HelpTextProperty
accLocation BoundingRectangleProperty
get_accDescription UI オートメーションではサポート対象外 accDescription に関する明確な仕様が MSAA 内に存在しなかったので、このプロパティに格納される情報はプロバイダーによって異なります。
get_accHelpTopic UI オートメーションではサポート対象外

次の表に、UI オートメーション プロパティと Active Accessibility の状態定数との対応を示します。

Active Accessibility の状態 UI オートメーションのプロパティ 状態の変更をトリガーする
STATE_SYSTEM_CHECKED チェック ボックスの場合、 ToggleStateProperty

オプション ボタンの場合、 IsSelectedProperty
Y
STATE_SYSTEM_COLLAPSED ExpandCollapseState = Collapsed Y
STATE_SYSTEM_EXPANDED ExpandCollapseState = Expanded または PartiallyExpanded Y
STATE_SYSTEM_FOCUSABLE IsKeyboardFocusableProperty N
STATE_SYSTEM_FOCUSED HasKeyboardFocusProperty N
STATE_SYSTEM_HASPOPUP ExpandCollapsePattern (メニュー項目の場合) N
STATE_SYSTEM_INVISIBLE IsOffscreenProperty = True かつ GetClickablePoint の場合に NoClickablePointException N
STATE_SYSTEM_LINKED ControlTypeProperty =

Hyperlink
N
STATE_SYSTEM_MIXED ToggleState = Indeterminate N
STATE_SYSTEM_MOVEABLE CanMoveProperty N
STATE_SYSTEM_MUTLISELECTABLE CanSelectMultipleProperty N
STATE_SYSTEM_OFFSCREEN IsOffscreenProperty = True N
STATE_SYSTEM_PROTECTED IsPasswordProperty N
STATE_SYSTEM_READONLY RangeValuePattern.IsReadOnlyProperty および ValuePattern.IsReadOnlyProperty N
STATE_SYSTEM_SELECTABLE SelectionItemPattern がサポートされています N
STATE_SYSTEM_SELECTED IsSelectedProperty N
STATE_SYSTEM_SIZEABLE CanResize N
STATE_SYSTEM_UNAVAILABLE IsEnabledProperty Y

次は、ほとんどの Active Accessibility コントロール サーバーで実装されていなかったか、UI オートメーションに対応するものがない状態を示します。

Active Accessibility の状態 解説
STATE_SYSTEM_BUSY UI オートメーションでは使用不可
STATE_SYSTEM_DEFAULT UI オートメーションでは使用不可
STATE_SYSTEM_ANIMATED UI オートメーションでは使用不可
STATE_SYSTEM_EXTSELECTABLE Active Accessibility サーバーで広範に実装されていません
STATE_SYSTEM_MARQUEED Active Accessibility サーバーで広範に実装されていません
STATE_SYSTEM_SELFVOICING Active Accessibility サーバーで広範に実装されていません
STATE_SYSTEM_TRAVERSED UI オートメーションでは使用不可
STATE_SYSTEM_ALERT_HIGH Active Accessibility サーバーで広範に実装されていません
STATE_SYSTEM_ALERT_MEDIUM Active Accessibility サーバーで広範に実装されていません
STATE_SYSTEM_ALERT_LOW Active Accessibility サーバーで広範に実装されていません
STATE_SYSTEM_FLOATING Active Accessibility サーバーで広範に実装されていません
STATE_SYSTEM_HOTTRACKED UI オートメーションでは使用不可
STATE_SYSTEM_PRESSED UI オートメーションでは使用不可

UI オートメーションのプロパティ識別子の完全な一覧については、「UI オートメーション プロパティの概要」を参照してください。

events

UI オートメーションのイベント機構は、Active Accessibility とは異なり、Windows のイベント ルーティング (ウィンドウ ハンドルと密接に関連する) に依存せず、クライアント アプリケーションでフックを設定する必要もありません。 イベントのサブスクリプションは、特定のイベントに対してだけでなく、ツリーの特定の部分を対象とするように細かく調整できます。 プロバイダーも、リッスンされているイベントを追跡して、イベントの生成を細かく調整できます。

イベントを生成した要素をクライアントで取得することも簡単です。このような要素は、イベント コールバックに直接渡されるからです。 クライアントがイベントをサブスクライブしているときにキャッシュ要求がアクティブであった場合は、自動的に要素のプロパティがプリフェッチされます。

次の表に、Active Accessibility の WinEvent と UI オートメーションのイベントとの対応を示します。

WinEvent UI オートメーション イベント識別子
EVENT_OBJECT_ACCELERATORCHANGE AcceleratorKeyProperty プロパティの変更
EVENT_OBJECT_CONTENTSCROLLED 関連付けられたスクロール バーにおける または プロパティの変更
EVENT_OBJECT_CREATE StructureChangedEvent
EVENT_OBJECT_DEFACTIONCHANGE 同等の機能がありません
EVENT_OBJECT_DESCRIPTIONCHANGE まったく同等の項目はありません (おそらく HelpTextProperty または LocalizedControlTypeProperty プロパティの変更)
EVENT_OBJECT_DESTROY StructureChangedEvent
EVENT_OBJECT_FOCUS AutomationFocusChangedEvent
EVENT_OBJECT_HELPCHANGE HelpTextProperty の変更
EVENT_OBJECT_HIDE StructureChangedEvent
EVENT_OBJECT_LOCATIONCHANGE BoundingRectangleProperty プロパティの変更
EVENT_OBJECT_NAMECHANGE NameProperty プロパティの変更
EVENT_OBJECT_PARENTCHANGE StructureChangedEvent
EVENT_OBJECT_REORDER Active Accessibility での使用は一貫していません。 直接対応するイベントが UI オートメーションでは定義されていません。
EVENT_OBJECT_SELECTION ElementSelectedEvent
EVENT_OBJECT_SELECTIONADD ElementAddedToSelectionEvent
EVENT_OBJECT_SELECTIONREMOVE ElementRemovedFromSelectionEvent
EVENT_OBJECT_SELECTIONWITHIN 同等の機能がありません
EVENT_OBJECT_SHOW StructureChangedEvent
EVENT_OBJECT_STATECHANGE さまざまなプロパティ変更イベント
EVENT_OBJECT_VALUECHANGE RangeValuePattern.ValueProperty および ValuePattern.ValueProperty の変更
EVENT_SYSTEM_ALERT 同等の機能がありません
EVENT_SYSTEM_CAPTUREEND 同等の機能がありません
EVENT_SYSTEM_CAPTURESTART 同等の機能がありません
EVENT_SYSTEM_CONTEXTHELPEND 同等の機能がありません
EVENT_SYSTEM_CONTEXTHELPSTART 同等の機能がありません
EVENT_SYSTEM_DIALOGEND WindowClosedEvent
EVENT_SYSTEM_DIALOGSTART WindowOpenedEvent
EVENT_SYSTEM_DRAGDROPEND 同等の機能がありません
EVENT_SYSTEM_DRAGDROPSTART 同等の機能がありません
EVENT_SYSTEM_FOREGROUND AutomationFocusChangedEvent
EVENT_SYSTEM_MENUEND MenuClosedEvent
EVENT_SYSTEM_MENUPOPUPEND MenuClosedEvent
EVENT_SYSTEM_MENUPOPUPSTART MenuOpenedEvent
EVENT_SYSTEM_MENUSTART MenuOpenedEvent
EVENT_SYSTEM_MINIMIZEEND WindowVisualStateProperty プロパティの変更
EVENT_SYSTEM_MINIMIZESTART WindowVisualStateProperty プロパティの変更
EVENT_SYSTEM_MOVESIZEEND BoundingRectangleProperty プロパティの変更
EVENT_SYSTEM_MOVESIZESTART BoundingRectangleProperty プロパティの変更
EVENT_SYSTEM_SCROLLINGEND VerticalScrollPercentProperty または HorizontalScrollPercentProperty プロパティの変更
EVENT_SYSTEM_SCROLLINGSTART VerticalScrollPercentProperty または HorizontalScrollPercentProperty プロパティの変更
EVENT_SYSTEM_SOUND 同等の機能がありません
EVENT_SYSTEM_SWITCHEND 同等の項目はありませんが、新しいアプリケーションがフォーカスを受け取ったことは AutomationFocusChangedEvent イベントによって通知されます。
EVENT_SYSTEM_SWITCHSTART 同等の機能がありません
同等の機能がありません CurrentViewProperty プロパティの変更
同等の機能がありません HorizontallyScrollableProperty プロパティの変更
同等の機能がありません VerticallyScrollableProperty プロパティの変更
同等の機能がありません HorizontalScrollPercentProperty プロパティの変更
同等の機能がありません VerticalScrollPercentProperty プロパティの変更
同等の機能がありません HorizontalViewSizeProperty プロパティの変更
同等の機能がありません VerticalViewSizeProperty プロパティの変更
同等の機能がありません ToggleStateProperty プロパティの変更
同等の機能がありません WindowVisualStateProperty プロパティの変更
同等の機能がありません AsyncContentLoadedEvent イベント
同等の機能がありません ToolTipOpenedEvent

セキュリティ

IAccessible をカスタマイズするシナリオでは、基本 IAccessible をラップしてからこれに対する呼び出しを行うという要件が生じることがあります。 このことは、セキュリティに影響を及ぼします。部分信頼コンポーネントにコード パスを中継させてはならないからです。

UI オートメーション モデルでは、プロバイダーが他のプロバイダー コードを呼び出す必要がありません。 必要な集約はすべて UI オートメーション コア サービスが行います。

関連項目