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 beim Zurückgeben von „UI Automation“-Elementen zu verwendenden Verweistyp angeben. Diese Werte werden in der AutomationElementMode-Eigenschaft verwendet.
public enum class AutomationElementModepublic enum AutomationElementModetype AutomationElementMode = Public Enum AutomationElementMode- Vererbung
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.
