IUIAutomationEventHandlerGroup::AddPropertyChangedEventHandler メソッド (uiautomationclient.h)

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

重要 Microsoft UI オートメーション クライアントでは、さまざまな IUIAutomation 名前空間で定義されている個々のイベント登録メソッドではなく、ハンドラー グループ メソッドを使用してイベント リスナーを登録する必要があります。

 

構文

HRESULT AddPropertyChangedEventHandler(
  [in] TreeScope                                scope,
  [in] IUIAutomationCacheRequest                *cacheRequest,
  [in] IUIAutomationPropertyChangedEventHandler *handler,
  [in] PROPERTYID                               *propertyArray,
       int                                      propertyCount
);

パラメーター

[in] scope

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

[in] cacheRequest

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

[in] handler

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

[in] propertyArray

目的の UI オートメーション プロパティへのポインター。 プロパティ ID の一覧については、「プロパティ識別子 」を参照してください。

propertyCount

監視対象のプロパティの数。

戻り値

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

備考

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

必要条件

要件	価値
サポートされる最小クライアント	Windows 10 バージョン 1809 [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server バージョン 1709 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	uiautomationclient.h (UIAutomation.h を含む)

関連項目

IUIAutomationEventHandlerGroup の