IUIAutomation ::AddPropertyChangedEventHandlerNativeArray, méthode (uiautomationclient.h)
Inscrit une méthode qui gère un tableau natif d’événements modifiés par des propriétés.
Syntaxe
HRESULT AddPropertyChangedEventHandlerNativeArray(
[in] IUIAutomationElement *element,
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.
scope
[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 du UI Automation propriétés d’intérêt. Pour obtenir la liste des ID de propriété, consultez Identificateurs de propriétés.
[in] propertyCount
Type : int
Nombre d’identificateurs de propriété dans propertyArray.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
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 Comment implémenter des gestionnaires d’événements.
Remarques
L’élément d’interface utilisateur spécifié par l’élément peut ne pas prendre en charge les propriétés spécifiées par le paramètre propertyArray .
Cette méthode sert le même objectif que IUIAutomation ::AddPropertyChangedEventHandler, mais prend un tableau normal d’identificateurs de propriétés 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é 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 7, Windows Vista avec SP2 et Platform Update pour Windows Vista, Windows XP avec SP3 et Platform Update pour Windows Vista [applications de bureau uniquement] |
Serveur minimal 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 |
En-tête | uiautomationclient.h (incluez UIAutomation.h) |
Voir aussi
AddPropertyChangedEventHandler
Mise en cache des propriétés UI Automation et des modèles de contrôle
Conceptuel
Référence
RemovePropertyChangedEventHandler
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour