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
イベント ハンドラーに関連付けられている UI オートメーション要素へのポインター。
[in] scope
型: TreeScope
処理されるイベントのスコープ。つまり、要素自体上にあるか、その先祖と子にかかっています。
[in] cacheRequest
キャッシュ要求へのポインター。キャッシュが必要ない場合は 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 の
スレッドの問題 について