IUIAutomationEventHandlerGroup ::AddChangesEventHandler, méthode (uiautomationclient.h)

Article
08/08/2024

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

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

Syntaxe

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

Paramètres

[in] scope

Étendue des événements à gérer ; c’est-à-dire, qu’ils soient sur l’élément lui-même, ou sur ses ancêtres et descendants.

[in] changeTypes

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

[in] changesCount

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

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

Valeur de retour

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

Remarques

Avant d’implémenter un gestionnaire d’événements, vous devez connaître les problèmes de thread décrits dans Understanding Threading Issues.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1809 [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server, version 1709 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	uiautomationclient.h (include UIAutomation.h)

Voir aussi

IUIAutomationEventHandlerGroup

Partager via