共用方式為

UiaEventCallback 回呼函式 (uiautomationcoreapi.h)

  • 發行項
注意 此函式已被取代。 用戶端應用程式應該改用 Microsoft UI 自動化元件物件模型 (COM) 介面。
 
用戶端實作的函式，會在引發用戶端已訂閱的事件時由使用者介面自動化呼叫。

語法

UiaEventCallback Uiaeventcallback;

void Uiaeventcallback(
  [in] UiaEventArgs *pArgs,
  [in] SAFEARRAY *pRequestedData,
  [in] BSTR pTreeStructure
)
{...}

參數

[in] pArgs

類型： UiaEventArgs*

包含事件引數的 UiaEventArgs 結構的位址。

[in] pRequestedData

類型： SAFEARRAY*

SAFEARRAY，其中包含與事件相關聯的資料。

[in] pTreeStructure

類型： BSTR

如果事件與一組節點相關聯，則為字串，其中包含與事件相關聯的樹狀結構。 請參閱＜備註＞。

傳回值

無

備註

此函式會傳遞至 UiaAddEvent 和 UiaRemoveEvent。

樹狀結構是由字串所描述，其中每個字元都是 「p」 或 「) 」。 字串中的第一個字元一律代表根節點。 如果函式未傳回任何專案，則字串為 Null 。

「p」 代表 (使用者介面自動化元素) 的節點。 當一個 「p」 直接遵循另一個時，第二個節點是第一個節點的子系。 「) 」 代表備份樹狀結構的步驟。 例如，「pp) p」 代表一個節點，後面接著兩個同層級的子節點。 在 「pp) ) p」 中，最後一個節點是第一個節點的同層級節點。

規格需求

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