Método IUIAutomation5::AddNotificationEventHandler (uiautomationclient.h)

Artigo
08/08/2024

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

Observação 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.

Sintaxe

HRESULT AddNotificationEventHandler(
  [in] IUIAutomationElement                  *element,
  [in] TreeScope                             scope,
  [in] IUIAutomationCacheRequest             *cacheRequest,
  [in] IUIAutomationNotificationEventHandler *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] cacheRequest

Tipo: * IUIAutomationCacheRequest

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

[in] handler

Tipo: * IUIAutomationNotificationEventHandler

Um ponteiro para o objeto que manipula o evento de notificação.

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.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1709 [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

IUIAutomation5

RemoveAllEventHandlers

Compartilhar via