Interfaccia IRawElementProviderAdviseEvents (uiautomationcore.h)

  • Articolo

Espone i metodi chiamati per notificare all'elemento radice di un frammento quando un'applicazione client di Microsoft Automazione interfaccia utente inizia o termina l'ascolto degli eventi su tale frammento.

Ereditarietà

L'interfaccia IRawElementProviderAdviseEvents eredita dall'interfaccia IUnknown . IRawElementProviderAdviseEvents include anche questi tipi di membri:

Metodi

L'interfaccia IRawElementProviderAdviseEvents include questi metodi.

 
IRawElementProviderAdviseEvents::AdviseEventAdded

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à.
IRawElementProviderAdviseEvents::AdviseEventRemoved

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

Commenti

L'implementazione di questa interfaccia è facoltativa. Può essere usato per migliorare le prestazioni generando eventi solo quando sono in ascolto.

Analogamente all'implementazione del conteggio dei riferimenti nella programmazione COM (Component Object Model), è importante che Automazione interfaccia utente provider trattino i metodi AdviseEventAdded e AdviseEventRemoved come i metodi AddRef e Release 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)