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

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

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

 

構文

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

パラメーター

[in] element

種類: IUIAutomationElement*

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

scope

[in] changeTypes

型: int*

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

[in] changesCount

型: int

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

[in] pCacheRequest

種類: IUIAutomationCacheRequest*

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

[in] handler

種類: IUIAutomationChangesEventHandler*

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

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

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

要件

要件	値
サポートされている最小のクライアント	Windows 10、バージョン 1607 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	uiautomationclient.h (UIAutomation.h を含む)

こちらもご覧ください

IUIAutomation4

RemoveAllEventHandlers