Méthode IUIAutomation4 ::AddChangesEventHandler (uiautomationclient.h)

Article
03/06/2024

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

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

Syntaxe

HRESULT AddChangesEventHandler(
  [in] IUIAutomationElement             *element,
       TreeScope                        scope,
  [in] int                              *changeTypes,
  [in] int                              changesCount,
  [in] IUIAutomationCacheRequest        *pCacheRequest,
  [in] IUIAutomationChangesEventHandler *handler
);

Paramètres

[in] element

Type : IUIAutomationElement*

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

scope

[in] changeTypes

Type : int*

Pointeur vers une liste d’entiers qui indiquent les types de modification que l’événement représente.

[in] changesCount

Type : int

Nombre de modifications qui se sont produites dans cet événement.

[in] pCacheRequest

Type : IUIAutomationCacheRequest*

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

[in] handler

Type : IUIAutomationChangesEventHandler*

Pointeur vers l’objet qui gère l’événement changes.

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 Microsoft 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 10, version 1607 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

IUIAutomation4

RemoveAllEventHandlers

Share via