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

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

Sintaxe

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

Um ponteiro para o elemento de Automação da Interface do Usuário associado ao manipulador de eventos.

[in] scope

Tipo: TreeScope

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

Tipo: int*

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

[in] changesCount

Tipo: int

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

[in] pCacheRequest

Tipo: * IUIAutomationCacheRequest

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

[in] handler

Tipo: * IUIAutomationChangesEventHandler

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

Valor de retorno

Tipo: HRESULT

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

Observações

Um cliente de Automação de Interface do Usuário da Microsoft não deve usar vários threads para adicionar ou remover manipuladores de eventos. Um comportamento inesperado pode resultar se um manipulador de eventos estiver sendo adicionado ou removido enquanto outro estiver sendo adicionado ou removido no mesmo processo de cliente.

Requisitos

Consulte também

IUIAutomation4

RemoveAllEventHandlers