IRawElementProviderAdviseEvents 接口 (uiautomationcore.h)

公开调用的方法,以便在 Microsoft UI 自动化客户端应用程序开始或结束侦听该片段上的事件时通知片段的根元素。

继承

IRawElementProviderAdviseEvents 接口继承自 IUnknown 接口。 IRawElementProviderAdviseEvents 也有以下类型的成员:

方法

IRawElementProviderAdviseEvents 接口具有这些方法。

 
IRawElementProviderAdviseEvents::AdviseEventAdded

当UI 自动化客户端开始侦听特定事件(包括属性更改事件)时,通知 Microsoft UI 自动化提供程序。
IRawElementProviderAdviseEvents::AdviseEventRemoved

当UI 自动化客户端停止侦听特定事件(包括属性更改事件)时,通知 Microsoft UI 自动化 提供程序。

注解

此接口的实现是可选的。 它可用于提高性能,方法是仅在侦听事件时引发事件。

与在组件对象模型 (COM) 编程中实现引用计数类似,UI 自动化提供程序必须处理 IUnknown 接口的 AddRefRelease 方法等 AdviseEventAddedAdviseEventRemoved 方法。 只要针对特定事件或属性调用 AdviseEventRemoved 的次数多于 AdviseEventRemoved ,提供程序就应继续引发相应的事件,因为某些客户端仍在侦听。 或者,UI 自动化提供程序可以使用 UiaClientsAreListening 函数来确定是否至少有一个客户端正在侦听,如果是,则引发所有适当的事件。

要求

要求
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 uiautomationcore.h (包括 UIAutomation.h)