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

• 03/30/2017
• • 
  • 
  • 

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

このトピックでは、UI オートメーションUI Automation の主な機能と、これらの機能が Active Accessibility とどのように異なるかについて説明します。This topic includes the main features of UI オートメーションUI Automation and explains how these features differ from Active Accessibility.

プログラミング言語Programming Languages

< Active Accessibility は、デュアルインターフェイスをサポートするコンポーネントオブジェクトモデル (COM) に基づいているため、C/C++、Microsoft Visual Basic 6.0、スクリプト言語でプログラミングできます。<Active Accessibility is based on the Component Object Model (COM) with support for dual interfaces, and is therefore programmable in C/C++, Microsoft 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 Accessibility のネイティブサポートは含まれていません。ただし、Active Accessibility クライアントのブリッジングサポートを含む UI オートメーションUI Automationをサポートしています。elements do not contain native support for Active Accessibility; however, they do support UI オートメーションUI Automation, which includes bridging support for Active 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 Accessibility では、サーバーとクライアントは、主にサーバーの IAccessibleの実装を介して直接通信します。In Active 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 Accessibility クライアントに情報を提供でき、Active Accessibility サーバーは UI オートメーションクライアントアプリケーションに情報を提供できます。UI Automation providers can provide information to Active Accessibility clients, and Active Accessibility servers can provide information to UI Automation client applications. ただし、Active Accessibility は UI オートメーションUI Automationほど多くの情報を公開しないため、2つのモデルは完全には互換性がありません。However, because Active Accessibility does not expose as much information as UI オートメーションUI Automation, the two models are not fully compatible.

UI 要素UI Elements

Active Accessibility は、IAccessible インターフェイスまたは子識別子として UIUI 要素を提示します。Active Accessibility 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 Accessibility では、エンドユーザーに関係のないオートメーション要素の多くがツリーで公開されます。In Active 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 Accessibility の要素間のナビゲーションは、空間 (画面の左側にある要素に移動するなど)、論理 (たとえば、次のメニュー項目に移動する、ダイアログボックス内のタブオーダーで次の項目に移動するなど)、または階層 (たとえば、コンテナー内の最初の子を移動したり、子からその親に移動したりすることができます。Navigation between elements, in Active 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 Accessibility よりも一貫性があります。Navigation in UI オートメーションUI Automation is more consistent than in Active Accessibility. ドロップダウンリストやポップアップウィンドウなどの一部の要素が Active Accessibility ツリーに2回表示され、それらの要素からのナビゲーションが予期しない結果になる場合があります。Some elements such as drop-down lists and pop-up windows appear twice in the Active Accessibility tree, and navigation from them may have unexpected results. 実際には、rebar コントロールに Active Accessibility を正しく実装することはできません。It is actually impossible to properly implement Active 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 Accessibility は、accRole プロパティ (IAccessible::get_actRole) を使用して、UIUI内の要素のロールの説明 (ROLE_SYSTEM_SLIDER や ROLE_SYSTEM_MENUITEM など) を取得します。Active Accessibility 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 Accessibility ロールと UI オートメーションUI Automation コントロール型とのマッピングを示しています。The following table shows the mapping of Active 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 Accessibility では、要素は共通のプロパティセットをサポートし、一部のプロパティ (accStateなど) は、要素のロールに応じて、非常に異なる項目を記述する必要があります。In Active 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 Accessibility の状態に対応しています。defines many more properties, some of which correspond to states in Active 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.

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

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

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

イベントEvents

UI オートメーションUI Automationのイベントメカニズムは、Active Accessibility とは異なり、Windows イベントルーティング (ウィンドウハンドルと密接に関連付けられています) に依存せず、クライアントアプリケーションでフックを設定する必要はありません。The event mechanism in UI オートメーションUI Automation, unlike that in Active 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 Accessibility WinEvents と UI オートメーションUI Automation イベントの対応を示しています。The following table shows the correspondence of Active 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