Partager via


IUIAutomation3 ::AddTextEditTextChangedEventHandler, méthode (uiautomationclient.h)

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

Note 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.
 

Syntaxe

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

Paramètres

[in] element

Type : IUIAutomationElement*

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

[in] scope

Type : TreeScope

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 : TextEditChangeType

Type de modification spécifique à écouter. Les clients s’inscrivent séparément pour chaque type de modification de texte, 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

Type : IUIAutomationCacheRequest*

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

[in] handler

Type : IUIAutomationTextEditTextChangedEventHandler*

Pointeur vers l’objet qui gère l’événement de modification de texte programmatique.

Valeur retournée

Type : HRESULT

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

Remarques

Un client UI Automation ne doit pas utiliser plusieurs threads pour ajouter ou supprimer des gestionnaires d’événements. Un comportement inattendu peut se produire si un gestionnaire d’événements est ajouté ou supprimé tandis qu’un autre est ajouté ou supprimé dans le même processus client.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

Mise en cache des propriétés UI Automation et des modèles de contrôle

Conceptuel

IUIAutomation3

Référence

RemoveAllEventHandlers

RemoveTextEditTextChangedEventHandler

Abonnement aux événements UI Automation

Présentation des problèmes liés au threading