IUIAutomation ::AddPropertyChangedEventHandlerNativeArray, méthode (uiautomationclient.h)

Article
08/08/2024

Inscrit une méthode qui gère un tableau natif d’événements modifiés par des propriétés.

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

Syntaxe

HRESULT AddPropertyChangedEventHandlerNativeArray(
  [in] IUIAutomationElement                     *element,
  [in] TreeScope                                scope,
  [in] IUIAutomationCacheRequest                *cacheRequest,
  [in] IUIAutomationPropertyChangedEventHandler *handler,
  [in] PROPERTYID                               *propertyArray,
  [in] int                                      propertyCount
);

Paramètres

[in] element

Type : IUIAutomationElement*

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

[in] scope

Type : TreeScope

É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 ses enfants.

[in] cacheRequest

Type : IUIAutomationCacheRequest*

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

[in] handler

Type : IUIAutomationPropertyChangedEventHandler*

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

[in] propertyArray

Type : PROPERTYID*

Pointeur vers les identificateurs des propriétés UI Automation d’intérêt. Pour obtenir la liste des ID de propriété, consultez identificateurs de propriété.

[in] propertyCount

Type : int

Nombre d’identificateurs de propriété dans propertyArray.

Valeur de retour

Type : HRESULT

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

exemple

Pour obtenir des exemples de code qui montrent comment implémenter des interfaces qui permettent aux clients de recevoir et de gérer des événements Microsoft UI Automation (y compris AddPropertyChangedEventHandlerNativeArray), consultez How to Implement Event Handlers.

Remarques

L’élément d’interface utilisateur spécifié par élément peut ne pas prendre en charge les propriétés spécifiées par le paramètre propertyArray .

Cette méthode a la même fonction que IUIAutomation ::AddPropertyChangedEventHandler, mais prend un tableau normal d’identificateurs de propriété au lieu d’un SAFEARRAY.

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é pendant qu’un autre est ajouté ou supprimé dans le même processus client.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista, Windows XP avec SP3 et Platform Update pour Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008, Windows Server 2003 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	uiautomationclient.h (include UIAutomation.h)