Méthode IUIAutomationCacheRequest ::p ut_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 put_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