Compartilhar via


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

Registra um método que manipula eventos de alteração.

Importante os clientes da Automação de Interface do Usuário da Microsoft devem usar os métodos de grupo de manipuladores para registrar ouvintes de eventos em vez de métodos de registro de eventos individuais definidos nos vários namespaces de IUIAutomation .
 

Sintaxe

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

Parâmetros

[in] scope

O escopo dos eventos a serem tratados; ou seja, se eles estão no próprio elemento, ou em seus ancestrais e descendentes.

[in] changeTypes

Um ponteiro para uma lista de inteiros que indicam os tipos de alteração que o evento representa.

[in] changesCount

O número de alterações que ocorreram nesse evento.

[in] cacheRequest

Um ponteiro para uma solicitação de cache ou NULL se nenhum cache for desejado.

[in] handler

Um ponteiro para o objeto que manipula o evento de alterações.

Valor de retorno

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

Antes de implementar um manipulador de eventos, você deve estar familiarizado com os problemas de threading descritos no Noções básicas sobre problemas de threading.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 10, versão 1809 [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server, versão 1709 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho uiautomationclient.h (include UIAutomation.h)

Consulte também

IUIAutomationEventHandlerGroup