Método IRawElementProviderAdviseEvents::AdviseEventAdded (uiautomationcore.h)
Notifica o provedor de Automação da Interface do Usuário da Microsoft quando um cliente Automação da Interface do Usuário começa a escutar um evento específico, incluindo um evento de alteração de propriedade.
Sintaxe
HRESULT AdviseEventAdded(
[in] EVENTID eventId,
[in] SAFEARRAY *propertyIDs
);
Parâmetros
[in] eventId
Tipo: EVENTID
O identificador do evento sendo adicionado. Para obter uma lista de IDs de evento, consulte Identificadores de evento.
[in] propertyIDs
Tipo: SAFEARRAY*
Um ponteiro para os identificadores das propriedades que estão sendo adicionadas ou NULL se o ouvinte de eventos que está sendo adicionado não estiver escutando eventos de propriedade.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Esse método permite que o provedor reduza a sobrecarga gerando apenas eventos que estão sendo escutados.
É importante que Automação da Interface do Usuário provedores tratem o IRawElementProviderAdviseEvents::AdviseEventAdded como o método AddRef 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, em caso afirmativo, 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 (include UIAutomation.h) |
Confira também
Práticas recomendadas para usar matrizes seguras
Conceitual
IRawElementProviderAdviseEvents
Referência