IUIAutomationCacheRequest::p ut_AutomationElementMode-Methode (uiautomationclient.h)

Gibt an, ob zurückgegebene Elemente vollständige Verweise auf die zugrunde liegende Benutzeroberfläche oder nur zwischengespeicherte Informationen enthalten.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_AutomationElementMode(
  AutomationElementMode mode
);

Parameter

mode

Rückgabewert

Keine

Bemerkungen

AutomationElementMode_Full ist der Standardwert und gibt an, dass zurückgegebene Elemente einen vollständigen Verweis auf die zugrunde liegende Benutzeroberfläche enthalten. AutomationElementMode_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, einschließlich GetCurrentPropertyValue und SetFocus, erfordern einen vollständigen Verweis. Der Versuch, dies für ein Element auszuführen, das über keines verfügt, führt zu einem Fehler.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationclient.h (include UIAutomation.h)