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

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

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

 

構文

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

パラメーター

scope

[in] cacheRequest

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

[in] handler

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

[in] propertyArray

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

propertyCount

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

戻り値

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

注釈

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

要件

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

こちらもご覧ください

IUIAutomationEventHandlerGroup