IRawElementProviderAdviseEvents::AdviseEventAdded-Methode (uiautomationcore.h)

Artikel
03/06/2024

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

Syntax

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

Parameter

[in] eventId

Typ: EVENTID

Der Bezeichner des hinzugefügten Ereignisses. Eine Liste der Ereignis-IDs finden Sie unter Ereignisbezeichner.

[in] propertyIDs

Typ: SAFEARRAY*

Ein Zeiger auf die Bezeichner der hinzugefügten Eigenschaften oder NULL , wenn der hinzugefügte Ereignislistener nicht auf Eigenschaftenereignisse lauscht.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode ermöglicht es dem Anbieter, den Mehraufwand zu reduzieren, indem nur Ereignisse ausgelöst werden, auf die lauscht wird.

Für Benutzeroberflächenautomatisierung Anbieter ist es wichtig, die IRawElementProviderAdviseEvents::AdviseEventAdded-Methode wie die AddRef-Methode 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)

Weitere Informationen

Bewährte Methoden für die Verwendung sicherer Arrays

Konzept

IRawElementProviderAdviseEvents

Referenz

Freigeben über