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.These values are used in the AutomationElementMode property.

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 utilisateurUI sous‑jacente.Specifies that returned elements have a full reference to the underlying Interface utilisateurUI.

None 0

Spécifie que les éléments retournés n'ont aucune référence à l'Interface utilisateurUI sous‑jacente et contiennent uniquement des informations mises en cache.Specifies that returned elements have no reference to the underlying Interface utilisateurUI and contain only cached information. 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.This mode might be used, for example, to retrieve the names of items in a list box without obtaining references to the items themselves.

Exemples

L’exemple suivant montre comment définir le mode sur un CacheRequest.The following example shows how to set the mode on a 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 interface utilisateur (UI)user interface (UI)une référence complète à l’sous-jacente.Full is the default, and specifies that returned elements contain a full reference to the underlying interface utilisateur (UI)user interface (UI). 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.None specifies that the returned elements have no reference to the underlying UI, and contain only cached information.

Certaines opérations sur des éléments, telles GetCurrentPropertyValue que SetFocusou, requièrent une référence complète; la tentative de les exécuter sur un élément qui n’a InvalidOperationExceptionaucun résultat dans un.Certain operations on elements, such as GetCurrentPropertyValue or SetFocus, require a full reference; attempting to perform these on an element that has none results in an InvalidOperationException.

L’utilisation de None peut s’avérer plus efficace lorsque seules des propriétés sont nécessaires, car elle évite la surcharge liée à la configuration de références complètes.Using None can be more efficient when only properties are needed, as it avoids the overhead involved in setting up full references.

S’applique à

Voir aussi