Método IUIAutomationEventHandlerGroup::AddPropertyChangedEventHandler (uiautomationclient.h)

Registra un método que controla un evento modificado por propiedad.

Importante los clientes de Automatización de la interfaz de usuario de Microsoft deben usar los métodos de grupo de controladores para registrar agentes de escucha de eventos en lugar de métodos de registro de eventos individuales definidos en los distintos espacios de nombres IUIAutomation.

 

Sintaxis

HRESULT AddPropertyChangedEventHandler(
  [in] TreeScope                                scope,
  [in] IUIAutomationCacheRequest                *cacheRequest,
  [in] IUIAutomationPropertyChangedEventHandler *handler,
  [in] PROPERTYID                               *propertyArray,
       int                                      propertyCount
);

Parámetros

[in] scope

Ámbito de los eventos que se van a controlar; es decir, si están en el propio elemento o en sus antecesores y elementos secundarios.

[in] cacheRequest

Puntero a una solicitud de caché o NULL si no se desea ningún almacenamiento en caché.

[in] handler

Puntero al objeto que controla el evento.

[in] propertyArray

Puntero a las propiedades de automatización de la interfaz de usuario de interés. Para obtener una lista de identificadores de propiedad, consulte Identificadores de propiedad.

propertyCount

Número de propiedades que se supervisan.

Valor devuelto

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

Observaciones

Antes de implementar un controlador de eventos, debe estar familiarizado con los problemas de subproceso descritos en Descripción de los problemas de subprocesos.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10, versión 1809 [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server, versión 1709 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	uiautomationclient.h (include UIAutomation.h)

Consulte también

IUIAutomationEventHandlerGroup