Partager via


AutomationElementMode Énumération

Définition

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 AutomationElementMode
public enum AutomationElementMode
type AutomationElementMode = 
Public Enum AutomationElementMode
Héritage
AutomationElementMode

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.

S’applique à

Voir aussi