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

Article
03/13/2024

Inscrit une méthode qui gère les événements de modification de texte par programmation.

Important Les clients Microsoft UI Automation doivent utiliser les méthodes de groupe de gestionnaires pour inscrire les é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 AddTextEditTextChangedEventHandler(
  [in] TreeScope                                    scope,
  [in] TextEditChangeType                           textEditChangeType,
  [in] IUIAutomationCacheRequest                    *cacheRequest,
  [in] IUIAutomationTextEditTextChangedEventHandler *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] textEditChangeType

Type de modification spécifique à écouter. Les clients s’inscrivent pour chaque type de modification de texte séparément, afin que le système UI Automation puisse case activée pour les écouteurs inscrits au moment de l’exécution et éviter de déclencher des événements pour des modifications de texte particulières lorsqu’il n’y a pas d’écouteurs.

[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 texte programmatique.

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 threads décrits dans Présentation des problèmes liés aux threads.

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