Méthode IUIAutomationEventHandlerGroup ::AddActiveTextPositionChangedEventHandler (uiautomationclient.h)

Article
06/29/2023

Inscrit une méthode (dans un groupe de gestionnaires d’événements) qui gère quand la position du texte actif change.

Important Les clients Microsoft UI Automation doivent utiliser les méthodes de groupe de gestionnaires pour inscrire des écouteurs d’événements au lieu des méthodes d’inscription d’événements individuelles définies dans les différents espaces de noms IUIAutomation.

Syntaxe

HRESULT AddActiveTextPositionChangedEventHandler(
  [in] TreeScope                                          scope,
  [in] IUIAutomationCacheRequest                          *cacheRequest,
  [in] IUIAutomationActiveTextPositionChangedEventHandler *handler
);

Paramètres

[in] scope

Portée des événements à gérer, c'est-à-dire s'ils sont sur l'élément lui-même, ou sur ses ancêtres et descendants.

[in] cacheRequest

Pointeur vers une demande de cache ou NULL si aucune mise en cache n’est souhaitée.

[in] handler

Pointeur vers l’objet qui gère l’événement de modification de la position du texte actif.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Avant d’implémenter un gestionnaire d’événements, vous devez être familiarisé avec les problèmes de thread décrits dans Présentation des problèmes liés aux threads.

La position du texte actif est indiquée par un événement de navigation dans ou entre des éléments de texte en lecture seule (tels que des navigateurs web, des documents PDF (Portable Document Format) ou des documents EPUB ) à l’aide de signets (ou d’identificateurs de fragments pour faire référence à un emplacement dans une ressource). Voici quelques exemples :

Accès à un signet dans la même page web
Navigation vers un signet sur une autre page web
Activation d’un lien vers un autre emplacement dans le même fichier PDF
Activation d’un lien vers un autre emplacement dans le même EPUB

Utilisez ce gestionnaire d’événements pour synchroniser l’emplacement visuel du signet/cible avec l’emplacement du focus dans un élément de texte en lecture seule, ce qui peut diverger lors de l’utilisation de signets ou d’identificateurs de fragments.

Par exemple, lorsqu’une même ancre de page (<a href=”#C4”>Jump to Chapter 4</a> ... <h1><a name="C4">Chapter 4</a></h1>) est appelée, l’emplacement visuel est mis à jour, mais le client UI Automation reste à l’emplacement d’origine. Cela entraîne des actions telles que la lecture de texte ou le déplacement des commandes d’élément suivant à partir de l’emplacement d’origine, et non du nouvel emplacement.

De même, l’activation d’un nouvel URI de page (avec un identificateur de fragment : (<a href=”www.blah.com#C4”>Jump to Chapter 4</a>)) charge la nouvelle page et accède au signet spécifié, mais laisse le UI Automation clients en haut de la page.

Pour les éléments de texte modifiables, tels que les contrôles Edit et Rich Edit , vous pouvez écouter un événement SelectionChanged.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1809 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server, version 1709 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

IUIAutomationEventHandlerGroup

Partager via