次の方法で共有


クライアントの UI オートメーション イベント

Note

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

このトピックでは、Microsoft UI オートメーション イベントを UI オートメーション クライアントで使用する方法について説明します。

UI オートメーションでは、クライアントは対象とするイベントをサブスクライブできます。 この機能により、情報、構造体または状態が変更されていないか確認するためにシステム内のすべての UI 要素を常にポーリングする必要がなくなるため、パフォーマンスが向上します。

また、定義されたスコープ内のイベントだけをリッスンできるため、効率性も向上します。 たとえば、クライアントはツリー内のすべての UI オートメーション要素のフォーカス変更イベントをリッスンすることも、1 つの要素とその子孫のフォーカス変更イベントだけをリッスンすることもできます。

Note

考えられるあらゆるイベントが Microsoft UI オートメーション プロバイダーによって発生するとは想定しないでください。 たとえば、すべてのプロパティ変更が、Windows フォームおよび Win32 コントロールの標準プロキシ プロバイダーによるイベント生成を引き起こすわけではありません。

UI オートメーション イベントの概要については、「UI オートメーション イベントの概要」を参照してください。

イベントのサブスクライブ

クライアント アプリケーションは特定の種類のイベントをサブスクライブするために、次のいずれかのメソッドを使用してイベント ハンドラーを登録します。

方法 イベントの種類 イベント引数の種類 デリゲート型
AddAutomationFocusChangedEventHandler フォーカスの変更 AutomationFocusChangedEventArgs AutomationFocusChangedEventHandler
AddAutomationPropertyChangedEventHandler プロパティの変更 AutomationPropertyChangedEventArgs AutomationPropertyChangedEventHandler
AddStructureChangedEventHandler 構造の変更 StructureChangedEventArgs StructureChangedEventHandler
AddAutomationEventHandler AutomationEvent で識別されるその他すべてのイベント AutomationEventArgs または WindowClosedEventArgs AutomationEventHandler

メソッドを呼び出す前に、イベントを処理するデリゲート メソッドを作成する必要があります。 必要に応じて、単一のメソッドでさまざまな種類のイベントを処理し、そのメソッドを複数の呼び出しで表中のメソッドの 1 つに渡すことができます。 たとえば、単一の AutomationEventHandler で、さまざまなメソッドを EventId に応じて異なる方法で処理するように設定できます。

Note

ウィンドウを閉じるイベントを処理するには、イベント ハンドラーに渡される引数の型を WindowClosedEventArgs にキャストします。 ウィンドウの Microsoft UI オートメーション要素は無効になるため、sender パラメーターを使用して情報を取得することはできないので、代わりに GetRuntimeId を使用します。

注意事項

アプリケーションが自身の UI からイベントを受け取る可能性がある場合、イベントのサブスクリプションまたはサブスクリプションの解除にアプリケーションの UI スレッドを使用しないでください。 使用すると、予期しない動作を招く可能性があります。 詳細については、「 UI オートメーション スレッド処理の問題点」を参照してください。

シャットダウン時、またはアプリケーションで UI オートメーション イベントに意味がなくなった場合、UI オートメーション クライアントが次のいずれかのメソッドを呼び出す必要があります。

Method 説明
RemoveAutomationEventHandler AddAutomationEventHandler を使用して登録されたイベント ハンドラーの登録を解除します。
RemoveAutomationFocusChangedEventHandler AddAutomationFocusChangedEventHandler を使用して登録されたイベント ハンドラーの登録を解除します。
RemoveAutomationPropertyChangedEventHandler AddAutomationPropertyChangedEventHandler を使用して登録されたイベント ハンドラーの登録を解除します。
RemoveAllEventHandlers 登録済みのすべてのイベント ハンドラーの登録を解除します。

コード例については、「UI オートメーション イベントのサブスクライブ」を参照してください。

関連項目