IUIAutomationProxyFactoryEntry::SetWinEventsForAutomationEvent メソッド (uiautomationclient.h)

Microsoft UI オートメーション イベントを WinEvents にマップします。

構文

HRESULT SetWinEventsForAutomationEvent(
  [in] EVENTID    eventId,
  [in] PROPERTYID propertyId,
  [in] SAFEARRAY  *winEvents
);

パラメーター

[in] eventId

種類: EVENTID

イベント識別子。 イベント識別子の一覧については、「 イベント識別子」を参照してください。

[in] propertyId

型: PROPERTYID

プロパティの識別子。 プロパティ ID の一覧については、「 プロパティ識別子」を参照してください。

[in] winEvents

種類: SAFEARRAY*

このイベントにマップされる WinEvents の一覧。

戻り値

型: HRESULT

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

注釈

クライアント アプリケーションが UI オートメーション イベントをサブスクライブすると、UI オートメーション コアも、このイベントにマップされる WinEvents をリッスンします。 たとえば、 UIA_Invoke_InvokedEventId が EVENT_OBJECT_INVOKED にマップされるとします。 EVENT_OBJECT_INVOKEDが発生すると、クライアントはプロキシをインスタンス化し、そのプロキシで RespondToWinEvent を呼び出します。 RespondToWinEvent の実装では、プロキシは AddAutomationEvent を呼び出します。 その後、コアは対応する UI オートメーション イベントを発生させます。

要件

要件	値
サポートされている最小のクライアント	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 を含む)

こちらもご覧ください

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

概念

GetWinEventsForAutomationEvent

IUIAutomationProxyFactoryEntry

参照