IUIAutomation4::AddChangesEventHandler-Methode (uiautomationclient.h)

  • Artikel

Registriert eine Methode, die Änderungsereignisse verarbeitet.

Hinweis Bevor Sie einen Ereignishandler implementieren, sollten Sie mit den Threadingproblemen vertraut sein, die unter Grundlegendes zu Threadingproblemen beschrieben werden.
 

Syntax

HRESULT AddChangesEventHandler(
  [in] IUIAutomationElement             *element,
       TreeScope                        scope,
  [in] int                              *changeTypes,
  [in] int                              changesCount,
  [in] IUIAutomationCacheRequest        *pCacheRequest,
  [in] IUIAutomationChangesEventHandler *handler
);

Parameter

[in] element

Typ: IUIAutomationElement*

Ein Zeiger auf das Benutzeroberflächenautomatisierung-Element, das dem Ereignishandler zugeordnet ist.

scope

[in] changeTypes

Typ: int*

Ein Zeiger auf eine Liste von ganzen Zahlen, die die Änderungstypen angeben, die das Ereignis darstellt.

[in] changesCount

Typ: int

Die Anzahl der Änderungen, die in diesem Ereignis aufgetreten sind.

[in] pCacheRequest

Typ: IUIAutomationCacheRequest*

Ein Zeiger auf eine Cacheanforderung oder NULL , wenn keine Zwischenspeicherung gewünscht ist.

[in] handler

Typ: IUIAutomationChangesEventHandler*

Ein Zeiger auf das -Objekt, das das Änderungsereignis behandelt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Ein Microsoft Benutzeroberflächenautomatisierung-Client sollte nicht mehrere Threads zum Hinzufügen oder Entfernen von Ereignishandlern verwenden. Unerwartetes Verhalten kann auftreten, wenn ein Ereignishandler hinzugefügt oder entfernt wird, während ein anderer im selben Clientprozess hinzugefügt oder entfernt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1607 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uiautomationclient.h (include UIAutomation.h)

Weitere Informationen

IUIAutomation4

RemoveAllEventHandlers