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

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

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

 

構文

HRESULT AddPropertyChangedEventHandler(
  [in] IUIAutomationElement                     *element,
  [in] TreeScope                                scope,
  [in] IUIAutomationCacheRequest                *cacheRequest,
  [in] IUIAutomationPropertyChangedEventHandler *handler,
  [in] SAFEARRAY                                *propertyArray
);

パラメーター

[in] element

型: IUIAutomationElement*

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

[in] scope

型: TreeScope

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

[in] cacheRequest

型: IUIAutomationCacheRequest*

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

[in] handler

型: IUIAutomationPropertyChangedEventHandler*

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

[in] propertyArray

型: SAFEARRAY*

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

戻り値

型: HRESULT

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

備考

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

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 を含む)

関連項目

AddPropertyChangedEventHandlerNativeArray の

安全な配列 を使用するための のベスト プラクティス

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

概念

IUIAutomation の

リファレンス

RemoveAllEventHandlers の

RemovePropertyChangedEventHandler の

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

スレッドの問題 について