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

Article
08/26/2023

Récupère un élément UI Automation pour l’objet accessible spécifié à partir d’un serveur Microsoft Active Accessibility, préfète les propriétés et les modèles de contrôle demandés, et stocke les éléments prédéfinis dans le cache.

Syntaxe

HRESULT ElementFromIAccessibleBuildCache(
  [in]          IAccessible               *accessible,
  [in]          int                       childId,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **element
);

Paramètres

[in] accessible

Type : IAccessible*

Pointeur vers l’interface IAccessible de l’objet accessible.

[in] childId

Type : int

ID enfant de l’objet accessible.

[in] cacheRequest

Type : IUIAutomationCacheRequest**

Adresse de la demande de cache qui spécifie les propriétés et les modèles de contrôle à stocker dans le cache.

[out, retval] element

Type : IUIAutomationElement**

Reçoit un pointeur vers l’élément UI Automation.

Valeur retournée

Type : HRESULT

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

Remarques

Cette méthode permet aux clients Microsoft UI Automation d’obtenir des interfaces IUIAutomationElement pour les objets accessibles implémentés par un serveur Microsoft Active Accessibility.

Cette méthode peut échouer si le serveur implémente les interfaces du fournisseur UI Automation avec la prise en charge de Microsoft Active Accessibility.

La méthode retourne E_INVALIDARG si l’implémentation sous-jacente de l’élément UI Automation n’est pas un serveur Microsoft Active Accessibility natif ; autrement dit, si un client tente de récupérer l’interface IAccessible pour un élément pris en charge à l’origine par un objet proxy à partir de Oleacc.dll, ou par le pont UIA-MSAA.

Configuration requise


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

IUIAutomation

IUIAutomation::ElementFromHandleBuildCache

Share via