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

Artigo
08/08/2024

Registra um método que manipula eventos de notificaçã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 AddNotificationEventHandler(
  [in] TreeScope                             scope,
  [in] IUIAutomationCacheRequest             *cacheRequest,
  [in] IUIAutomationNotificationEventHandler *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] 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 notificação.

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

Compartilhar via