IUIAutomation4::AddChangesEventHandler メソッド (uiautomationclient.h)

変更イベントを処理するメソッドを登録します。

構文

HRESULT AddChangesEventHandler(
  [in] IUIAutomationElement             *element,
  [in] TreeScope                        scope,
  [in] int                              *changeTypes,
  [in] int                              changesCount,
  [in] IUIAutomationCacheRequest        *pCacheRequest,
  [in] IUIAutomationChangesEventHandler *handler
);

パラメーター

[in] element

型: IUIAutomationElement*

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

[in] scope

型: TreeScope

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

[in] changeTypes

型: int*

イベントが表す変更の種類を示す整数のリストへのポインター。

[in] changesCount

型: int

このイベントで発生した変更の数。

[in] pCacheRequest

型: IUIAutomationCacheRequest*

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

[in] handler

型: IUIAutomationChangesEventHandler*

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

戻り値

型: HRESULT

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

備考

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

必要条件

関連項目

IUIAutomation4 の

RemoveAllEventHandlers の