AutomationElementMode Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Contient des valeurs qui spécifient le type de référence à utiliser quand des éléments UI Automation sont retournés. Ces valeurs sont utilisées dans la propriété AutomationElementMode.
public enum class AutomationElementModepublic enum AutomationElementModetype AutomationElementMode = Public Enum AutomationElementMode- Héritage
Champs
| Full | 1 | Spécifie que les éléments retournés ont une référence complète à l’interface utilisateur sous-jacente. |
| None | 0 | 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. Ce mode peut être utilisé pour, par exemple, récupérer les noms d'éléments figurant dans une zone de liste sans obtenir de références aux éléments eux‑mêmes. |
Exemples
L’exemple suivant montre comment définir le mode sur un CacheRequest.
// Set up the request.
CacheRequest cacheRequest = new CacheRequest();
// Do not get a full reference to the cached objects, only to their cached properties and patterns.
cacheRequest.AutomationElementMode = AutomationElementMode.None;
' Set up the request.
Dim cacheRequest As New CacheRequest()
' Do not get a full reference to the cached objects, only to their cached properties and patterns.
cacheRequest.AutomationElementMode = AutomationElementMode.None
Remarques
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. Aucun 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 les éléments, telles que GetCurrentPropertyValue ou SetFocus, nécessitent une référence complète ; si vous essayez de les effectuer sur un élément qui n’en a aucun, un InvalidOperationException.
L’utilisation de 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.
