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

  • [アーティクル]

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

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

構文

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

パラメーター

[in] element

型: IUIAutomationElement*

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

[in] scope

型: TreeScope

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

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

関連項目

AddPropertyChangedEventHandler の

UI オートメーションのプロパティとコントロール パターンのキャッシュ

概念

IUIAutomation の

リファレンス

RemoveAllEventHandlers の

RemovePropertyChangedEventHandler の

UI オートメーション イベントのサブスクライブ

スレッドの問題 について