IUIAutomationEventHandlerGroup::AddTextEditTextChangedEventHandler-Methode (uiautomationclient.h)

Artikel
03/03/2024

Registriert eine Methode, die programmgesteuerte Textbearbeitungsereignisse verarbeitet.

Wichtig Microsoft Benutzeroberflächenautomatisierung Clients sollten die Methoden der Handlergruppe verwenden, um Ereignislistener zu registrieren, anstatt einzelne Ereignisregistrierungsmethoden, die in den verschiedenen IUIAutomation-Namespaces definiert sind.

Syntax

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

Parameter

[in] scope

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

[in] textEditChangeType

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

[in] cacheRequest

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

[in] handler

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

Rückgabewert

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

Hinweise

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

Anforderungen

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

Weitere Informationen

IUIAutomationEventHandlerGroup

Share via