共用方式為

IRawElementProviderAdviseEvents：：AdviseEventAdded 方法 (uiautomationcore.h)

  • 發行項

當 使用者介面自動化 客戶端開始接聽特定事件時，通知 Microsoft 使用者介面自動化 提供者，包括屬性變更的事件。

語法

HRESULT AdviseEventAdded(
  [in] EVENTID   eventId,
  [in] SAFEARRAY *propertyIDs
);

參數

[in] eventId

類型： EVENTID

要加入之事件的識別項。 如需事件標識碼的清單，請參閱 事件標識碼。

[in] propertyIDs

類型： SAFEARRAY*

要加入之屬性標識碼的指標，如果加入的事件接聽程式未接聽屬性事件，則為 NULL 。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

這個方法可讓提供者只引發正在接聽的事件，以減少額外負荷。

使用者介面自動化 提供者務必處理 IRawElementProviderAdviseEvents：：AdviseEventAdded，就像 IUnknown 介面的 AddRef 方法一樣。 只要已針對特定事件或屬性呼叫 AdviseEventRemoved 多次 ， 提供者就應該繼續引發對應的事件，因為某些用戶端仍在接聽中。 或者，使用者介面自動化 提供者可以使用UiaClientsAreListening函式來判斷是否至少有一個用戶端正在接聽，如果是的話，請引發所有適當的事件。

規格需求

需求 值
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 uiautomationcore.h (包含 UIAutomation.h)

另請參閱

使用安全數位的最佳做法

概念

IRawElementProviderAdviseEvents

參考