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

Registra un método que controla los eventos modificados por la estructura.

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 AddStructureChangedEventHandler(
  [in] TreeScope                                 scope,
  [in] IUIAutomationCacheRequest                 *cacheRequest,
  [in] IUIAutomationStructureChangedEventHandler *handler
);

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 descendientes.

[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 modificado por la estructura.

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