Compartilhar via

Método IUIAutomation6::AddEventHandlerGroup (uiautomationclient.h)

  • Artigo

Registra uma coleção de métodos de manipulador de eventos especificados com a IUIAutomation6::CreateEventHandlerGroup.

Importante

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

Sintaxe

HRESULT AddEventHandlerGroup(
  [in] IUIAutomationElement           *element,
       IUIAutomationEventHandlerGroup *handlerGroup
);

Parâmetros

[in] element

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

handlerGroup

Uma coleção de ouvintes de eventos Automação da Interface do Usuário.

Retornar valor

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

Comentários

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

É possível que um evento seja entregue a um manipulador de eventos depois que o manipulador tiver sido cancelado, se o evento for recebido simultaneamente com a solicitação para cancelar a assinatura do evento. A melhor prática é seguir o padrão COM (Component Object Model) e evitar destruir o objeto do manipulador de eventos até que sua contagem de referência tenha atingido zero. Destruir um manipulador de eventos imediatamente após a não assinatura de eventos pode resultar em uma violação de acesso se um evento for entregue com atraso.

Requisitos

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

Confira também

Interface IUIAutomation6::RemoveEventHandlerGroup, IUIAutomation6