Méthode IUIAutomationCacheRequest::get_AutomationElementMode (uiautomationclient.h)

Indique si les éléments retournés contiennent des références complètes à l’interface utilisateur sous-jacente ou uniquement des informations mises en cache.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_AutomationElementMode(
  AutomationElementMode *mode
);

Paramètres

mode

Valeur de retour

None

Remarques

AutomationElementMode_Full est la valeur par défaut et spécifie que les éléments retournés contiennent une référence complète à l’interface utilisateur sous-jacente. AutomationElementMode_None spécifie que les éléments retournés n’ont aucune référence à l’interface utilisateur sous-jacente et contiennent uniquement des informations mises en cache.

Certaines opérations sur des éléments, notamment GetCurrentPropertyValue et SetFocus, nécessitent une référence complète ; la tentative d’exécution de ces opérations sur un élément qui n’en contient aucun entraîne une erreur.

L’utilisation de AutomationElementMode_None peut être plus efficace lorsque seules des propriétés sont nécessaires, car elle évite la surcharge liée à la configuration des références complètes.

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)