共用方式為

UiaAddEvent 函式 (uiautomationcoreapi.h)

  • 發行項
注意 此函式已被取代。 用戶端應用程式應該改用 Microsoft UI 自動化元件物件模型 (COM) 介面。
 
在 UI 自動化樹狀結構中的節點上新增事件的接聽程式。

語法

HRESULT UiaAddEvent(
  [in]  HUIANODE         hnode,
  [in]  EVENTID          eventId,
  [in]  UiaEventCallback *pCallback,
  [in]  TreeScope        scope,
  [in]  PROPERTYID       *pProperties,
  [in]  int              cProperties,
  [in]  UiaCacheRequest  *pRequest,
  [out] HUIAEVENT        *phEvent
);

參數

[in] hnode

類型： HUIANODE

要加入事件接聽程式的節點。

[in] eventId

類型： EVENTID

要接聽之事件的識別碼。 如需事件識別碼的清單，請參閱 事件識別碼。

[in] pCallback

類型： UiaEventCallback*

引發事件時呼叫之應用程式定義 UiaEventCallback 回 呼函式的位址。

[in] scope

類型： TreeScope*

TreeScope列舉型別的值，指出要處理的事件範圍;也就是說，無論是位於元素本身，還是在其上階和子系上。

[in] pProperties

類型： PROPERTYID*

陣列的位址，其中包含要監視變更事件之屬性的識別碼，當 eventId 是衍生自 AutomationPropertyChanged_Event_GUID 的 EVENTID 時;否則此參數為 Null。 如需屬性識別碼的清單，請參閱 屬性識別碼。

[in] cProperties

類型： int

pProperties陣列中的專案計數。

[in] pRequest

類型： UiaCacheRequest*

UiaCacheRequest結構的位址，定義事件傳回之節點生效的快取要求。

[out] phEvent

類型： HUIEVENT*

當此函式傳回時，會包含已加入之事件的指標。 這個參數會以未初始化的狀態傳遞。

傳回值

類型： HRESULT

如果成功或錯誤值，則傳回S_OK。

需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 uiautomationcoreapi.h
程式庫 Uiautomationcore.lib
Dll Uiautomationcore.dll

另請參閱

UiaLookupId