IUIAutomation6 ::RemoveActiveTextPositionChangedEventHandler, méthode (uiautomationclient.h)

Supprime un gestionnaire d’événements de modification de position de texte actif.

Syntaxe

HRESULT RemoveActiveTextPositionChangedEventHandler(
  [in] IUIAutomationElement                               *element,
  [in] IUIAutomationActiveTextPositionChangedEventHandler *handler
);

Paramètres

[in] element

Pointeur vers l’élément UI Automation associé au gestionnaire d’événements.

[in] handler

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

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Avant d’implémenter un gestionnaire d’événements, vous devez être familiarisé avec les problèmes de threads 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 à l’intérieur ou entre des éléments de texte en lecture seule (tels que les navigateurs web, les documents PDF (Portable Document Format) ou les documents EPUB ) à l’aide de signets (ou d’identificateurs de fragment pour faire référence à un emplacement au sein d’une ressource). Voici quelques exemples :

• Navigation vers 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/de la 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 Modifier et Modifier enrichi , vous pouvez écouter un événement SelectionChanged.

Il est possible qu’un événement soit remis à un gestionnaire d’événements une fois que le gestionnaire a été désinscrit, si l’événement est reçu simultanément avec la demande de désinscription de l’événement. La meilleure pratique consiste à suivre la norme COM (Component Object Model) et à éviter de détruire l’objet gestionnaire d’événements tant que son nombre de références n’a pas atteint zéro. La destruction d’un gestionnaire d’événements immédiatement après la désinscripation des événements peut entraîner une violation d’accès si un événement est remis en retard.

Configuration requise

Voir aussi

IUIAutomation6 ::AddActiveTextPositionChangedEventHandler, interface IUIAutomation6