Metodo IRawElementProviderAdviseEvents::AdviseEventAdded (uiautomationcore.h)

Articolo
03/03/2024

Notifica al provider di Automazione interfaccia utente Microsoft quando un client di Automazione interfaccia utente inizia ad ascoltare un evento specifico, incluso un evento di modifica della proprietà.

Sintassi

HRESULT AdviseEventAdded(
  [in] EVENTID   eventId,
  [in] SAFEARRAY *propertyIDs
);

Parametri

[in] eventId

Tipo: EVENTID

Identificatore dell'evento da aggiungere. Per un elenco degli ID evento, vedere Identificatori di evento.

[in] propertyIDs

Tipo: SAFEARRAY*

Puntatore agli identificatori delle proprietà da aggiungere o NULL se il listener di eventi da aggiungere non è in ascolto degli eventi di proprietà.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo consente al provider di ridurre il sovraccarico generando solo eventi in ascolto.

È importante che Automazione interfaccia utente provider trattino IRawElementProviderAdviseEvents::AdviseEventAdded come il metodo AddRef dell'interfaccia IUnknown. Finché AdviseEventAdded è stato chiamato più volte rispetto a AdviseEventRemoved per un evento o una proprietà specifica, il provider deve continuare a generare eventi corrispondenti, perché alcuni client sono ancora in ascolto. In alternativa, Automazione interfaccia utente provider possono usare la funzione UiaClientsAreListening per determinare se almeno un client è in ascolto e, in tal caso, generare tutti gli eventi appropriati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcore.h (include UIAutomation.h)

Vedi anche

Procedure consigliate per l'uso di matrici sicure

Informazioni concettuali

IRawElementProviderAdviseEvents

Riferimento

Condividi tramite