IUIAutomationEventHandlerGroup::AddActiveTextPositionChangedEventHandler-Methode (uiautomationclient.h)

Artikel
03/06/2024

Registriert eine Methode (in einer Ereignishandlergruppe), die behandelt, wenn sich die aktive Textposition ändert.

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

Syntax

HRESULT AddActiveTextPositionChangedEventHandler(
  [in] TreeScope                                          scope,
  [in] IUIAutomationCacheRequest                          *cacheRequest,
  [in] IUIAutomationActiveTextPositionChangedEventHandler *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] cacheRequest

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

[in] handler

Ein Zeiger auf das -Objekt, das das aktive Textpositionsänderungsereignis 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.

Die position des aktiven Texts wird durch ein Navigationsereignis innerhalb oder zwischen schreibgeschützten Textelementen (z. B. Webbrowsern, PDF-Dokumenten oder EPUB-Dokumenten ) mithilfe von Lesezeichen (oder Fragmentbezeichnern, die auf einen Speicherort innerhalb einer Ressource verweisen) angegeben. Beispiele:

Navigieren zu einem Lesezeichen auf derselben Webseite
Navigieren zu einem Lesezeichen auf einer anderen Webseite
Aktivieren eines Links zu einem anderen Speicherort innerhalb derselben PDF-Datei
Aktivieren eines Links zu einem anderen Standort innerhalb derselben EPUB

Verwenden Sie diesen Ereignishandler, um die visuelle Position des Lesezeichens/Ziels mit der Fokusposition in einem schreibgeschützten Textelement zu synchronisieren, was bei Verwendung von Lesezeichen oder Fragmentbezeichnern abweichen kann.

Wenn beispielsweise ein derselben Seitenanker (<a href=”#C4”>Jump to Chapter 4</a> ... <h1><a name="C4">Chapter 4</a></h1>) aufgerufen wird, wird der visuelle Speicherort aktualisiert, der Benutzeroberflächenautomatisierung Client bleibt jedoch am ursprünglichen Speicherort. Dies führt zu Aktionen wie Textlesen oder Verschieben von Befehlen zum nächsten Element vom ursprünglichen Speicherort, nicht vom neuen Speicherort.

Auf ähnliche Weise wird beim Aktivieren eines neuen Seiten-URI (mit fragmentbezeichner: (<a href=”www.blah.com#C4”>Jump to Chapter 4</a>)) die neue Seite geladen und zum angegebenen Lesezeichen springt, aber die Benutzeroberflächenautomatisierung Clients am oberen Rand der Seite bleiben.

Für bearbeitbare Textelemente, z. B. Edit- und Rich Edit-Steuerelemente , können Sie auf ein SelectionChanged-Ereignis lauschen.

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

Freigeben über