AutomationElementMode Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Enthält Werte, die den Typ des Verweises angeben, der beim Zurückgeben von Benutzeroberflächenautomatisierung Elementen verwendet werden soll. Diese Werte werden in der AutomationElementMode-Eigenschaft verwendet.
public enum class AutomationElementModepublic enum AutomationElementModetype AutomationElementMode = Public Enum AutomationElementMode- Vererbung
Felder
| Name | Wert | Beschreibung |
|---|---|---|
| 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 beispielsweise verwendet werden, um die Namen von Elementen in einem Listenfeld abzurufen, ohne Verweise auf die Elemente selbst abzurufen. |
| Full | 1 | Gibt an, dass zurückgegebene Elemente über einen vollständigen Verweis auf die zugrunde liegende Benutzeroberfläche verfügen. |
Beispiele
Das folgende Beispiel zeigt, wie der Modus für ein 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
Hinweise
"Vollständig" ist der Standardwert und gibt an, dass zurückgegebene Elemente einen vollständigen Verweis auf die zugrunde liegende Benutzeroberfläche (UI) enthalten. Keine 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. Sie versuchen, diese für ein Element auszuführen, das keine Ergebnisse enthält InvalidOperationException.
Die Verwendung von None kann effizienter sein, wenn nur Eigenschaften benötigt werden, da dadurch der Aufwand beim Einrichten vollständiger Verweise vermieden wird.
