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

• 03/30/2017
• 共同作成者
  • 
  • 
  • 

アプリケーションをアクセス可能にするための以前のソリューションはMicrosoft Active AccessibilityMicrosoft Active Accessibility です。Microsoft Active AccessibilityMicrosoft Active Accessibility was the earlier solution for making applications accessible. Microsoft UI オートメーションMicrosoft UI Automation は Microsoft WindowsMicrosoft Windows の新しいユーザー補助モデルであり、その目的は支援技術製品と自動テスト ツールのニーズを解決することです。is the new accessibility model for Microsoft WindowsMicrosoft Windows and is intended to address the needs of assistive technology products and automated testing tools. UI オートメーションUI Automation は多くの点で Active AccessibilityActive Accessibility よりも強化されています。offers many improvements over Active AccessibilityActive Accessibility.

このトピックでは、 UI オートメーションUI Automation の主な機能を紹介し、 Active AccessibilityActive Accessibilityとの違いについて説明します。This topic includes the main features of UI オートメーションUI Automation and explains how these features differ from Active AccessibilityActive Accessibility.

プログラミング言語Programming Languages

<Active AccessibilityActive Accessibility に基づいて、コンポーネント オブジェクト モデル (COM)Component Object Model (COM)をデュアル インターフェイスは、サポートされるため、C および C++ でプログラミング可能なMicrosoft Visual Basic 6.0Microsoft Visual Basic 6.0、およびスクリプト言語です。<Active AccessibilityActive Accessibility is based on the コンポーネント オブジェクト モデル (COM)Component Object Model (COM) with support for dual interfaces, and is therefore programmable in C/C++, Microsoft Visual Basic 6.0Microsoft Visual Basic 6.0, and scripting languages. UI オートメーションUI Automation (標準コントロールのクライアント側プロバイダー ライブラリを含む) は、マネージ コードで記述し、UI オートメーション クライアント アプリケーションは、c# または Visual Basic .NET を使用して最も簡単にプログラミングされます。(including the client-side provider library for standard controls) is written in managed code, and UI Automation client applications are most easily programmed using C# or Visual Basic .NET. インターフェイスを実装する UI オートメーション プロバイダーは、マネージド コードまたは C/C++ で記述できます。UI Automation providers, which are interface implementations, can be written in managed code or in C/C++.

Windows Presentation Foundation におけるサポートSupport in Windows Presentation Foundation

Windows Presentation Foundation (WPF) は、ユーザー インターフェイスを作成するための新しいモデルです。Windows Presentation Foundation (WPF) is the new model for creating user interfaces. WPFWPF の要素には Active AccessibilityActive Accessibilityのネイティブ サポート機能はありませんが、 UI オートメーションUI Automationをサポートしており、これに Active AccessibilityActive Accessibility クライアントのためのブリッジ サポートが含まれています。elements do not contain native support for Active AccessibilityActive Accessibility; however, they do support UI オートメーションUI Automation, which includes bridging support for Active AccessibilityActive Accessibility clients. UI オートメーションUI Automation 専用に作成されたクライアントだけが WPFWPFのユーザー補助機能 (テキストに関する豊富なサポートなど) を最大限に利用できます。Only clients written specifically for UI オートメーションUI Automation can take full advantage of the accessibility features of WPFWPF, such as the rich support for text.

サーバーとクライアントServers and Clients

Active AccessibilityActive Accessibilityでは、サーバーとクライアントは、主にサーバーによる IAccessibleの実装を介して直接通信します。In Active AccessibilityActive Accessibility, servers and clients communicate directly, largely through the server's implementation of IAccessible.

UI オートメーションUI Automationでは、サーバー (プロバイダー) とクライアントの間にコア サービスが存在します。In UI オートメーションUI Automation, a core service lies between the server (called a provider) and the client. このコア サービスは、プロバイダーによって実装されたインターフェイスを呼び出して、追加のサービス (要素の一意のランタイム識別子の生成など) を提供します。The core service makes calls to the interfaces implemented by providers and provides additional services such as generating unique runtime identifiers for elements. クライアント アプリケーションはライブラリ関数を使用して UI オートメーションUI Automation サービスを呼び出します。Client applications use library functions to call the UI オートメーションUI Automation service.

UI オートメーション プロバイダーは Active AccessibilityActive Accessibility クライアントに情報を提供でき、 Active AccessibilityActive Accessibility サーバーは UI オートメーション クライアント アプリケーションに情報を提供できます。UI Automation providers can provide information to Active AccessibilityActive Accessibility clients, and Active AccessibilityActive Accessibility servers can provide information to UI Automation client applications. ただし、 Active AccessibilityActive Accessibility は UI オートメーションUI Automationほど多くの情報を公開しないため、この 2 つのモデルには完全な互換性がありません。However, because Active AccessibilityActive Accessibility does not expose as much information as UI オートメーションUI Automation, the two models are not fully compatible.

UI 要素UI Elements

Active AccessibilityActive Accessibility では UIUI 要素を IAccessible インターフェイスまたは子識別子として表現します。presents UIUI elements either as an IAccessible interface or as a child identifier. 2 つの IAccessible ポインターを比較してそれらが同じ要素を参照しているかどうかを判断するのは困難です。It is difficult to compare two IAccessible pointers to determine if they refer to the same element.

UI オートメーションUI Automationでは、すべての要素が AutomationElement オブジェクトとして表現されます。In UI オートメーションUI Automation, every element is represented as an AutomationElement object. 比較は等値演算子または Equals メソッドを使用して行われますが、どちらの方法でも、要素の一意のランタイム識別子が比較されます。Comparison is done by using the equality operator or the Equals method, both of which compare the unique runtime identifiers of the elements.

ツリー ビューとナビゲーションTree Views and Navigation

画面上の ユーザー インターフェイス (UI)user interface (UI) 要素は、ツリー構造で表すことができます。デスクトップがルートで、その直接の子としてアプリケーション ウィンドウがあり、アプリケーション内の要素がその子孫となります。The ユーザー インターフェイス (UI)user interface (UI) elements on the screen can be seen as a tree structure with the desktop as the root, application windows as immediate children, and elements within applications as further descendants.

Active AccessibilityActive Accessibilityでは、エンドユーザーには無関係なオートメーション要素も多数、ツリー内に公開されます。In Active AccessibilityActive Accessibility, many automation elements that are irrelevant to end users are exposed in the tree. クライアント アプリケーションは、すべての要素の中から意味のあるものを特定する必要があります。Client applications have to look at all the elements to determine which are meaningful.

UI オートメーション クライアント アプリケーションは、フィルタリングしたビューを使用して UIUI を確認します。UI Automation client applications see the UIUI through a filtered view. このビューには、必要な要素 (ユーザーに情報を提供したり、対話を可能にしたりする要素) のみが表示されます。The view contains only elements of interest: those that give information to the user or enable interaction. コントロール要素だけが含まれるビューや、コンテンツ要素だけが含まれるビューがあらかじめ定義されています。さらに、アプリケーションでカスタム ビューを定義することもできます。Predefined views of only control elements and only content elements are available; in addition, applications can define custom views. UI オートメーションUI Automation は、ユーザーに対して UIUI を簡単に表せるようにして、ユーザーとアプリケーションの対話を支援します。simplifies the task of describing the UIUI to the user and helping the user interact with the application.

Active AccessibilityActive Accessibilityにおける要素間ナビゲーションは、空間的 (画面上で左にある要素に移動するなど)、論理的 (次のメニュー項目に移動する、ダイアログ ボックスのタブ オーダー内で次の項目に移動するなど)、階層的 (コンテナー内の最初の子に移動する、子からその親に移動するなど) のいずれかです。Navigation between elements, in Active AccessibilityActive Accessibility, is either spatial (for example, moving to the element that lies to the left on the screen), logical (for example, moving to the next menu item, or the next item in the tab order within a dialog box), or hierarchical (for example, moving the first child in a container, or from the child to its parent). 子要素が IAccessibleを実装しているオブジェクトであるとは限らないため、階層的ナビゲーションは複雑です。Hierarchical navigation is complicated by the fact that child elements are not always objects that implement IAccessible.

UI オートメーションUI Automationでは、すべての UIUI 要素は、同じ基本機能をサポートする AutomationElement オブジェクトですIn UI オートメーションUI Automation, all UIUI elements are AutomationElement objects that support the same basic functionality. (プロバイダーの観点では、IRawElementProviderSimple から継承されたインターフェイスを実装するオブジェクトです)。ナビゲーションは主に階層的 (親から子、兄弟から次の兄弟) です (From the standpoint of the provider, they are objects that implement an interface inherited from IRawElementProviderSimple.) Navigation is mainly hierarchical: from parents to children, and from one sibling to the next. (兄弟間のナビゲーションは、タブ オーダーに従う場合があるため、論理的要素も持っています)。フィルタリングされたツリー ビューで TreeWalker クラスを使用して、任意の場所からナビゲーションを開始できます。(Navigation between siblings has a logical element, as it may follow the tab order.) You can navigate from any starting-point, using any filtered view of the tree, by using the TreeWalker class. FindFirst と FindAllを使用して、特定の子または子孫に移動することもできます。たとえば、指定したコントロール パターンがサポートされるダイアログ ボックス内のすべての要素を非常に簡単に取得できます。You can also navigate to particular children or descendants by using FindFirst and FindAll; for example, it is very easy to retrieve all elements within a dialog box that support a specified control pattern.

UI オートメーションUI Automation におけるナビゲーションは Active AccessibilityActive Accessibilityにおけるナビゲーションより一貫性があります。Navigation in UI オートメーションUI Automation is more consistent than in Active AccessibilityActive Accessibility. ドロップダウン リストやポップアップ ウィンドウなど、 Active AccessibilityActive Accessibility ツリーに 2 回表示される要素がありますが、このような要素からナビゲーションすると、予期しない結果が生じる可能性があります。Some elements such as drop-down lists and pop-up windows appear twice in the Active AccessibilityActive Accessibility tree, and navigation from them may have unexpected results. 実際には、rebar コントロールに対して Active AccessibilityActive Accessibility を正しく実装することは不可能です。It is actually impossible to properly implement Active AccessibilityActive Accessibility for a rebar control. UI オートメーションUI Automation では親の再指定や位置の変更が可能なため、ウィンドウの所有関係による階層にかかわらず、要素をツリー内の任意の場所に配置できます。enables reparenting and repositioning, so that an element can be placed anywhere in the tree despite the hierarchy imposed by ownership of windows.

役割とコントロール型Roles and Control Types

Active AccessibilityActive Accessibility は、 accRole プロパティ (IAccessible::get_actRole) を使用して、ROLE_SYSTEM_SLIDER や ROLE_SYSTEM_MENUITEM などの UIUI内の要素のｙｗの記述を取得します。uses the accRole property (IAccessible::get_actRole) to retrieve a description of the element's role in the UIUI, such as ROLE_SYSTEM_SLIDER or ROLE_SYSTEM_MENUITEM. 要素の役割は、要素の機能を表す主要な鍵になります。The role of an element is the main clue to its available functionality. コントロールとの対話は、 IAccessible::accSelect や IAccessible::accDoDefaultActionなどの固定のメソッドを使用して実現されます。Interaction with a control is achieved by using fixed methods such as IAccessible::accSelect and IAccessible::accDoDefaultAction. クライアント アプリケーションと UIUI の間の対話は、 IAccessibleを通して実行できる範囲に限定されます。The interaction between the client application and the UIUI is limited to what can be done through IAccessible.

これに対して、 UI オートメーションUI Automation では、要素のコントロール型 ( ControlType プロパティで記述) と、その要素に期待される機能とが大きく分離されています。In contrast, UI オートメーションUI Automation largely decouples the control type of the element (described by the ControlType property) from its expected functionality. 機能は、特殊なインターフェイスの実装を通じてプロバイダーによってサポートされる、コントロール パターンによって決定されます。Functionality is determined by the control patterns that are supported by the provider through its implementation of specialized interfaces. 複数のコントロール パターンを組み合わせると、特定の UIUI 要素がサポートする機能をすべて記述することができます。Control patterns can be combined to describe the full set of functionality supported by a particular UIUI element. プロバイダーによっては、ある 1 つの特定のコントロール パターンをサポートしなければならないものがあります。たとえば、チェック ボックスのプロバイダーは Toggle コントロール パターンをサポートする必要があります。Some providers are required to support a particular control pattern; for example, the provider for a check box must support the Toggle control pattern. また、コントロール パターンのセットを 1 つ以上サポートしなければならないものもあります。たとえば、ボタンは、Toggle と Invoke のいずれかをサポートする必要があります。Other providers are required to support one or more of a set of control patterns; for example, a button must support either Toggle or Invoke. さらに、コントロール パターンをまったくサポートしないものもあります。たとえば、移動もサイズ変更もドッキングもできないペインには、コントロール パターンはありません。Still others support no control patterns at all; for example, a pane that cannot be moved, resized, or docked does not have any control patterns.

UI オートメーションUI Automation は、 Custom プロパティによって識別され、 LocalizedControlTypeProperty プロパティによって記述可能なカスタム コントロールをサポートします。supports custom controls, which are identified by the Custom property and can be described by the LocalizedControlTypeProperty property.

次の表に、 Active AccessibilityActive Accessibility の役割と UI オートメーションUI Automation のコントロール型のマッピングを示します。The following table shows the mapping of Active AccessibilityActive Accessibility roles to UI オートメーションUI Automation control types.

さまざまなコントロール型の詳細については、「 UI Automation Control Types」を参照してください。For more information about the different control types, see UI Automation Control Types.

状態とプロパティStates and Properties

Active AccessibilityActive Accessibilityでは、要素は一般的なプロパティのセットをサポートします。一部のプロパティ ( accStateなど) は、要素の役割に応じてまったく異なる内容を記述する必要があります。In Active AccessibilityActive Accessibility, elements support a common set of properties, and some properties (such as accState) must describe very different things, depending on the element's role. サーバーは、プロパティを返す IAccessible のメソッドをすべて (要素に無関係なものも含む) 実装する必要があります。Servers must implement all methods of IAccessible that return a property, even those that are not relevant to the element.

UI オートメーションUI Automation では、さらに多くのプロパティが定義されており、その一部は Active AccessibilityActive Accessibilityでの状態に対応します。defines many more properties, some of which correspond to states in Active AccessibilityActive Accessibility. すべての要素に共通するものもあれば、コントロール型とコントロール パターンに固有のものもあります。Some are common to all elements, but others are specific to control types and control patterns. プロパティは一意の識別子によって識別され、ほとんどのプロパティは単一のメソッド ( GetCurrentPropertyValue または GetCachedPropertyValue) を使用して取得できます。Properties are distinguished by unique identifiers, and most properties can be retrieved by using a single method, GetCurrentPropertyValue or GetCachedPropertyValue. 多くのプロパティは、 Current プロパティ アクセサーおよび Cached プロパティ アクセサーからも容易に取得できます。Many properties are also easily retrievable from the Current and Cached property accessors.

UI オートメーション プロバイダーは、無関係なプロパティを実装する必要はなく、サポートしていないプロパティに対しては単に null 値を返すことができます。A UI Automation provider does not have to implement irrelevant properties, but can simply return a null value for any properties it does not support. また、 UI オートメーションUI Automation のコア サービスは、一部のプロパティを既定のウィンドウ プロバイダーから取得できます。これらのプロパティは、プロバイダーによって明示的に実装されたプロパティと 1 つにまとめられます。Also, the UI オートメーションUI Automation core service can obtain some properties from the default window provider, and these are amalgamated with properties explicitly implemented by the provider.

UI オートメーションUI Automation では、多くのプロパティをサポートすることに加えて、単一のプロセス間呼び出しで複数のプロパティを取得できるので、パフォーマンスが向上します。As well as supporting many more properties, UI オートメーションUI Automation supplies better performance by allowing multiple properties to be retrieved with a single cross-process call.

次の表に、2 つのモデルのプロパティ間の対応を示します。The following table shows the correspondence between properties in the two models.

次の表に、 UI オートメーションUI Automation プロパティと Active AccessibilityActive Accessibility の状態定数との対応を示します。The following table shows which UI オートメーションUI Automation properties correspond to Active AccessibilityActive Accessibility state constants.

次は、ほとんどの Active AccessibilityActive Accessibility コントロール サーバーで実装されていなかったか、 UI オートメーションUI Automationに対応するものがない状態を示します。The following states either were not implemented by most Active AccessibilityActive Accessibility control servers or have no equivalent in UI オートメーションUI Automation.

完全な一覧についてはUI オートメーションUI Automationプロパティの識別子を参照してくださいUI Automation Properties Overviewします。For a complete list of UI オートメーションUI Automation property identifiers, see UI Automation Properties Overview.

イベントEvents

UI オートメーションUI Automationのイベント機構は、 Active AccessibilityActive Accessibilityとは異なり、Windows のイベント ルーティング (ウィンドウ ハンドルと密接に関連する) に依存せず、クライアント アプリケーションでフックを設定する必要もありません。The event mechanism in UI オートメーションUI Automation, unlike that in Active AccessibilityActive Accessibility, does not rely on Windows event routing (which is closely tied in with window handles) and does not require the client application to set up hooks. イベントのサブスクリプションは、特定のイベントに対してだけでなく、ツリーの特定の部分を対象とするように細かく調整できます。Subscriptions to events can be fine-tuned not just to particular events but to particular parts of the tree. プロバイダーも、リッスンされているイベントを追跡して、イベントの生成を細かく調整できます。Providers can also fine-tune their raising of events by keeping track of what events are being listened for.

イベントを生成した要素をクライアントで取得することも簡単です。このような要素は、イベント コールバックに直接渡されるからです。It is also easier for clients to retrieve the elements that raise events, as these are passed directly to the event callback. クライアントがイベントをサブスクライブしているときにキャッシュ要求がアクティブであった場合は、自動的に要素のプロパティがプリフェッチされます。Properties of the element are automatically prefetched if a cache request was active when the client subscribed to the event.

次の表に、 Active AccessibilityActive Accessibility の WinEvent と UI オートメーションUI Automation のイベントとの対応を示します。The following table shows the correspondence of Active AccessibilityActive Accessibility WinEvents and UI オートメーションUI Automation events.

セキュリティSecurity

IAccessible をカスタマイズするシナリオでは、基本 IAccessible をラップしてからこれに対する呼び出しを行うという要件が生じることがあります。Some IAccessible customization scenarios require wrapping a base IAccessible and calling through to it. このことは、セキュリティに影響を及ぼします。部分信頼コンポーネントにコード パスを中継させてはならないからです。This has security implications, since a partially trusted component should not be an intermediary on a code path.

UI オートメーションUI Automation モデルでは、プロバイダーが他のプロバイダー コードを呼び出す必要がありません。The UI オートメーションUI Automation model removes the need for providers to call through to other provider code. 必要な集約はすべて UI オートメーションUI Automation コア サービスが行います。The UI オートメーションUI Automation core service does all the necessary aggregation.

関連項目See also

• UI オートメーションの基礎UI Automation Fundamentals