IRawElementProviderAdviseEvents-Schnittstelle (uiautomationcore.h)

  • Artikel

Macht Methoden verfügbar, die aufgerufen werden, um das Stammelement eines Fragments zu benachrichtigen, wenn eine Microsoft Benutzeroberflächenautomatisierung-Clientanwendung beginnt oder auf Ereignisse in diesem Fragment lauscht.

Vererbung

Die IRawElementProviderAdviseEvents-Schnittstelle erbt von der IUnknown-Schnittstelle . IRawElementProviderAdviseEvents verfügt auch über die folgenden Typen von Membern:

Methoden

Die IRawElementProviderAdviseEvents-Schnittstelle verfügt über diese Methoden.

 
IRawElementProviderAdviseEvents::AdviseEventAdded

Benachrichtigt den Microsoft Benutzeroberflächenautomatisierung-Anbieter, wenn ein Benutzeroberflächenautomatisierung-Client beginnt, auf ein bestimmtes Ereignis zu lauschen, einschließlich eines Eigenschaftsänderungsereignisses.
IRawElementProviderAdviseEvents::AdviseEventRemoved

Benachrichtigt den Microsoft Benutzeroberflächenautomatisierung-Anbieter, wenn ein Benutzeroberflächenautomatisierung-Client nicht mehr auf ein bestimmtes Ereignis lauscht, einschließlich eines Eigenschaftsänderungsereignisses.

Hinweise

Die Implementierung dieser Schnittstelle ist optional. Es kann verwendet werden, um die Leistung zu verbessern, indem Ereignisse nur ausgelöst werden, wenn sie überwacht werden.

Ähnlich wie bei der Implementierung der Referenzzählung in der COM-Programmierung (Component Object Model) ist es für Benutzeroberflächenautomatisierung Anbieter wichtig, die Methoden AdviseEventAdded und AdviseEventRemoved wie die AddRef- und Release-Methoden der IUnknown-Schnittstelle zu behandeln. Solange AdviseEventAdded für ein bestimmtes Ereignis oder eine bestimmte Eigenschaft öfter aufgerufen wurde als AdviseEventRemoved , sollte der Anbieter weiterhin entsprechende Ereignisse auslösen, da einige Clients weiterhin lauschen. Alternativ können Benutzeroberflächenautomatisierung Anbieter die Funktion UiaClientsAreListening verwenden, um zu bestimmen, ob mindestens ein Client lauscht, und wenn ja, alle entsprechenden Ereignisse auslösen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile uiautomationcore.h (include UIAutomation.h)