Compartir a través de

Método IRawElementProviderAdviseEvents::AdviseEventAdded (uiautomationcore.h)

  • Artículo

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.

Sintaxis

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

Parámetros

[in] eventId

Tipo: EVENTID

El identificador del evento que se agrega. Para obtener una lista de identificadores de eventos, consulte Identificadores de eventos.

[in] propertyIDs

Tipo: SAFEARRAY*

Puntero a los identificadores de las propiedades que se agregan o NULL si el agente de escucha de eventos que se va a agregar no está escuchando eventos de propiedad.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método permite al proveedor reducir la sobrecarga mediante la generación de solo eventos que se escuchan.

Es importante que los proveedores de Automatización de la interfaz de usuario traten el IRawElementProviderAdviseEvents::AdviseEventAdded como el método AddRef 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)

Consulte también

Procedimientos recomendados para usar matrices seguras

Conceptual

IRawElementProviderAdviseEvents

Referencia