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 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 Accessibility の上には、多くの機能強化を提供します。offers many improvements over Active Accessibility.

このトピックには主な機能が含まれていますUI オートメーションUI AutomationActive 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)Component Object Model (COM)をデュアル インターフェイスは、サポートされるため、C# でプログラミング可能な/C++、 Microsoft Visual Basic 6.0Microsoft Visual Basic 6.0、およびスクリプト言語です。<Active 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 Accessibility; に対するネイティブ サポートはありません。ただし、それらをサポートしてUI オートメーションUI Automation、ブリッジのクライアントの Active Accessibility のサポートが含まれています。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 提示UIUI要素として、IAccessibleインターフェイスまたは子識別子として。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 AutomationActive 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) で、要素のロールの説明を取得する、 UIUIROLE_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.

次の表ではUI オートメーションUI Automationプロパティが Active Accessibility 状態定数に対応しています。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 Automation Properties Overviewします。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.

次の表に、アクティブなユーザー補助の Winevent との関係と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