IUIAutomation::AddAutomationEventHandler メソッド (uiautomationclient.h)

Microsoft UI オートメーション イベントを処理するメソッドを登録します。

注意 イベント ハンドラーを実装する前に、「スレッド処理の問題についてに関するページで説明されているスレッドの問題をよく理解しておく必要があります。

 

構文

HRESULT AddAutomationEventHandler(
  [in] EVENTID                   eventId,
  [in] IUIAutomationElement      *element,
  [in] TreeScope                 scope,
  [in] IUIAutomationCacheRequest *cacheRequest,
  [in] IUIAutomationEventHandler *handler
);

パラメーター

[in] eventId

型: EVENTID

メソッドが処理するイベントの識別子。 イベント ID の一覧については、「イベント識別子」を参照してください。

[in] element

型: IUIAutomationElement*

イベント ハンドラーに関連付ける UI オートメーション要素へのポインター。

[in] scope

型: TreeScope

処理されるイベントのスコープ。つまり、要素自体上にあるか、その先祖と子孫上にあるか。

[in] cacheRequest

型: IUIAutomationCacheRequest*

キャッシュ要求へのポインター。キャッシュが必要ない場合は NULL 。

[in] handler

型: IUIAutomationEventHandler*

イベントを処理するオブジェクトへのポインター。

戻り値

型: HRESULT

このメソッドが成功した場合は、S_OKを返します。 それ以外の場合は、HRESULT エラー コードが返されます。

備考

UI オートメーション クライアントでは、イベント ハンドラーを追加または削除するために複数のスレッドを使用しないでください。 同じクライアント プロセスで別のイベント ハンドラーが追加または削除されている間に、1 つのイベント ハンドラーが追加または削除されると、予期しない動作が発生する可能性があります。

必要条件

要件	価値
サポートされる最小クライアント	Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム、Windows XP SP3 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム、Windows Server 2003 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	uiautomationclient.h (UIAutomation.h を含む)

関連項目

UI オートメーションのプロパティとコントロール パターンのキャッシュ

概念

IUIAutomation の

IUIAutomationEventHandler の

リファレンス

RemoveAllEventHandlers の

RemoveAutomationEventHandler の

UI オートメーション イベントのサブスクライブ

スレッドの問題 について