Teilen über


AutomationElementMode Enumeration

Definition

Enthält Werte, die den beim Zurückgeben von „UI Automation“-Elementen zu verwendenden Verweistyp angeben. Diese Werte werden in der AutomationElementMode-Eigenschaft verwendet.

public enum class AutomationElementMode
public enum AutomationElementMode
type AutomationElementMode = 
Public Enum AutomationElementMode
Vererbung
AutomationElementMode

Felder

Full 1

Gibt an, dass zurückgegebene Elemente über einen vollständigen Verweis auf die zugrunde liegende Benutzeroberfläche verfügen.

None 0

Gibt an, dass zurückgegebene Elemente keinen Verweis auf die zugrunde liegende Benutzeroberfläche haben und nur zwischengespeicherte Informationen enthalten. Dieser Modus kann z. B. verwendet werden, um die Namen von Elementen in einem Listenfeld abzurufen, ohne Verweise auf die Elemente selbst abzurufen.

Beispiele

Das folgende Beispiel zeigt, wie der Modus für ein CacheRequestfestgelegt wird.

// 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

Hinweise

Full ist die Standardeinstellung und gibt an, dass zurückgegebene Elemente einen vollständigen Verweis auf die zugrunde liegende Benutzeroberfläche enthalten. None gibt an, dass die zurückgegebenen Elemente keinen Verweis auf die zugrunde liegende Benutzeroberfläche haben und nur zwischengespeicherte Informationen enthalten.

Bestimmte Vorgänge für Elemente, z GetCurrentPropertyValue . B. oder SetFocus, erfordern einen vollständigen Verweis. Der Versuch, diese für ein Element auszuführen, das keines hat, führt zu einem InvalidOperationException.

Die Verwendung von None kann effizienter sein, wenn nur Eigenschaften benötigt werden, da der Aufwand beim Einrichten vollständiger Verweise vermieden wird.

Gilt für:

Weitere Informationen