Método IUIAutomation4::AddChangesEventHandler (uiautomationclient.h)

Registra un método que controla los eventos de cambio.

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

 

Sintaxis

HRESULT AddChangesEventHandler(
  [in] IUIAutomationElement             *element,
  [in] TreeScope                        scope,
  [in] int                              *changeTypes,
  [in] int                              changesCount,
  [in] IUIAutomationCacheRequest        *pCacheRequest,
  [in] IUIAutomationChangesEventHandler *handler
);

Parámetros

[in] element

Tipo: IUIAutomationElement

Puntero al elemento de automatización de la interfaz de usuario asociado al controlador de eventos.

[in] scope

Tipo: treeScope de

Á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] changeTypes

Tipo: int*

Puntero a una lista de enteros que indican los tipos de cambio que representa el evento.

[in] changesCount

Tipo: int

Número de cambios que se produjeron en este evento.

[in] pCacheRequest

Tipo: IUIAutomationCacheRequest*

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

[in] handler

Tipo: IUIAutomationChangesEventHandler*

Puntero al objeto que controla el evento de cambios.

Valor devuelto

Tipo: HRESULT

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

Observaciones

Un cliente de Automatización de la interfaz de usuario de Microsoft no debe usar varios subprocesos para agregar o quitar controladores de eventos. El comportamiento inesperado puede producir si se agrega o quita un controlador de eventos mientras se agrega o quita otro en el mismo proceso de cliente.

Requisitos

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

Consulte también

IUIAutomation4

removeAllEventHandlers