IUIAutomation3::AddTextEditTextChangedEventHandler-Methode (uiautomationclient.h)

Artikel
03/03/2024

Registriert eine Methode, die programmgesteuerte Textbearbeitungsereignisse verarbeitet.

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

Syntax

HRESULT AddTextEditTextChangedEventHandler(
  [in] IUIAutomationElement                         *element,
  [in] TreeScope                                    scope,
  [in] TextEditChangeType                           textEditChangeType,
  [in] IUIAutomationCacheRequest                    *cacheRequest,
  [in] IUIAutomationTextEditTextChangedEventHandler *handler
);

Parameter

[in] element

Typ: IUIAutomationElement*

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

[in] scope

Typ: TreeScope

Der Umfang der zu behandelnden Elemente, d. h. ob die Ereignisse bei dem Element selbst oder bei Vorgänger- oder Nachfolgerelementen eintreten.

[in] textEditChangeType

Typ: TextEditChangeType

Der spezifische Änderungstyp, auf den lauscht werden soll. Clients registrieren sich für jeden Textbearbeitungsänderungstyp separat, sodass das Benutzeroberflächenautomatisierung-System zur Laufzeit nach registrierten Listenern suchen kann und ereignisse für bestimmte Textbearbeitungsänderungen vermeiden kann, wenn keine Listener vorhanden sind.

[in] cacheRequest

Typ: IUIAutomationCacheRequest*

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

[in] handler

Typ: IUIAutomationTextEditTextChangedEventHandler*

Ein Zeiger auf das -Objekt, das das programmgesteuerte Textbearbeitungsereignis verarbeitet.

Rückgabewert

Typ: HRESULT

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

Hinweise

Ein Benutzeroberflächenautomatisierung-Client sollte nicht mehrere Threads verwenden, um Ereignishandler hinzuzufügen oder zu entfernen. 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 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationclient.h (include UIAutomation.h)