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

Confira também

Práticas recomendadas para usar matrizes seguras

Conceitual

IRawElementProviderAdviseEvents

Referência