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

[アーティクル]
08/26/2023

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

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

構文

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

パラメーター

[in] element

種類: IUIAutomationElement*

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

scope

[in] cacheRequest

種類: IUIAutomationCacheRequest*

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

[in] handler

型: IUIAutomationPropertyChangedEventHandler*

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

[in] propertyArray

型: PROPERTYID*

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

[in] propertyCount

型: int

propertyArray 内のプロパティ識別子の数。

戻り値

型: HRESULT

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

例

クライアントが Microsoft UI オートメーションイベント (AddPropertyChangedEventHandlerNativeArray を含む) を受信して処理できるようにするインターフェイスを実装する方法を示すコード例については、「イベントハンドラーを実装する方法」を参照してください。

注釈

要素で指定された UI 項目は、propertyArray パラメーターで指定されたプロパティをサポートしていない可能性があります。

このメソッドは IUIAutomation::AddPropertyChangedEventHandler と同じ目的を果たしますが、SAFEARRAY の代わりに通常のプロパティ識別子の配列を受け取ります。

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 用プラットフォーム更新プログラム [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	uiautomationclient.h (UIAutomation.h を含む)