Compartilhar via

Interface IRawElementProviderAdviseEvents (uiautomationcore.h)

  • Artigo

Expõe métodos que são chamados para notificar o elemento raiz de um fragmento quando um aplicativo cliente do Microsoft Automação da Interface do Usuário começa ou termina de escutar eventos nesse fragmento.

Herança

A interface IRawElementProviderAdviseEvents herda da interface IUnknown . IRawElementProviderAdviseEvents também tem esses tipos de membros:

Métodos

A interface IRawElementProviderAdviseEvents tem esses métodos .

 
IRawElementProviderAdviseEvents::AdviseEventAdded

Notifica o provedor do Microsoft Automação da Interface do Usuário quando um cliente Automação da Interface do Usuário começa a escutar um evento específico, incluindo um evento alterado por propriedade.
IRawElementProviderAdviseEvents::AdviseEventRemoved

Notifica o provedor do Microsoft Automação da Interface do Usuário quando um cliente Automação da Interface do Usuário para de escutar um evento específico, incluindo um evento alterado pela propriedade.

Comentários

A implementação dessa interface é opcional. Ele pode ser usado para melhorar o desempenho gerando eventos somente quando eles estão sendo ouvidos.

Semelhante à implementação da contagem de referência na programação COM (Component Object Model), é importante que Automação da Interface do Usuário provedores tratem os métodos AdviseEventAdded e AdviseEventRemoved, como os métodos AddRef e Release da interface IUnknown. Desde que AdviseEventAdded tenha sido chamado mais vezes do que AdviseEventRemoved para um evento ou propriedade específico, o provedor deve continuar a gerar eventos correspondentes, pois alguns clientes ainda estão escutando. Como alternativa, Automação da Interface do Usuário provedores podem usar a função UiaClientsAreListening para determinar se pelo menos um cliente está escutando e, nesse caso, gerar todos os eventos apropriados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho uiautomationcore.h (inclua UIAutomation.h)