共用方式為

IRawElementProviderAdviseEvents：：AdviseEventRemoved 方法 (uiautomationcore.h)

  • 發行項

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

語法

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

參數

[in] eventId

類型： EVENTID

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

[in] propertyIDs

類型： SAFEARRAY*

要移除之屬性識別碼的指標，如果移除的事件接聽程式未接聽屬性事件， 則為 Null 。

傳回值

類型： HRESULT

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

備註

這個方法可讓提供者藉由只引發正在接聽的事件來降低額外負荷。

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

需求

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

另請參閱

使用安全陣列的最佳做法

概念

IRawElementProviderAdviseEvents

參考