Interfaz IRawElementProviderAdviseEvents (uiautomationcore.h)

  • Artículo

Expone métodos a los que se llama para notificar al elemento raíz de un fragmento cuando una aplicación cliente de Microsoft Automatización de la interfaz de usuario comienza o termina escuchando eventos en ese fragmento.

Herencia

La interfaz IRawElementProviderAdviseEvents hereda de la interfaz IUnknown . IRawElementProviderAdviseEvents también tiene estos tipos de miembros:

Métodos

La interfaz IRawElementProviderAdviseEvents tiene estos métodos.

 
IRawElementProviderAdviseEvents::AdviseEventAdded

Notifica al proveedor de Microsoft Automatización de la interfaz de usuario cuando un cliente de Automatización de la interfaz de usuario comienza a escuchar un evento específico, incluido un evento modificado por la propiedad.
IRawElementProviderAdviseEvents::AdviseEventRemoved

Notifica al proveedor de Microsoft Automatización de la interfaz de usuario cuando un cliente de Automatización de la interfaz de usuario deja de escuchar un evento específico, incluido un evento modificado por la propiedad.

Comentarios

La implementación de esta interfaz es opcional. Se puede usar para mejorar el rendimiento mediante la generación de eventos solo cuando se escuchan.

De forma similar a la implementación del recuento de referencias en la programación del Modelo de objetos componentes (COM), es importante que los proveedores de Automatización de la interfaz de usuario traten los métodos AdviseEventAdded y AdviseEventRemoved, como los métodos AddRef y Release de la interfaz IUnknown. Siempre que se haya llamado a AdviseEventAdded más veces que AdviseEventRemoved para un evento o propiedad específicos, el proveedor debe seguir generando eventos correspondientes, ya que algunos clientes siguen escuchando. Como alternativa, los proveedores de Automatización de la interfaz de usuario pueden usar la función UiaClientsAreListening para determinar si al menos un cliente está escuchando y, si es así, generar todos los eventos adecuados.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado uiautomationcore.h (incluir UIAutomation.h)