IUIAutomationElement::GetCachedPropertyValueEx-Methode (uiautomationclient.h)

Artikel
03/13/2024

Ruft einen Eigenschaftswert aus dem Cache für dieses Benutzeroberflächenautomatisierung-Element ab, wobei optional alle Standardwerte ignoriert werden.

Syntax

HRESULT GetCachedPropertyValueEx(
  [in]          PROPERTYID propertyId,
  [in]          BOOL       ignoreDefaultValue,
  [out, retval] VARIANT    *retVal
);

Parameter

[in] propertyId

Typ: PROPERTYID

Der Bezeichner der Eigenschaft. Eine Liste der Eigenschaften-IDs finden Sie unter Eigenschaftenbezeichner.

[in] ignoreDefaultValue

Typ: BOOL

Ein Wert, der angibt, ob ein Standardwert ignoriert werden soll, wenn die angegebene Eigenschaft nicht unterstützt wird: TRUE , wenn der Standardwert nicht zurückgegeben werden soll, oder FALSE , wenn er zurückgegeben werden soll.

[out, retval] retVal

Typ: VARIANT*

Empfängt den Wert der Eigenschaft.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode ruft die angegebene Eigenschaft aus dem Cache für das Benutzeroberflächenautomatisierung-Element ab. Um die aktuelle Eigenschaft abzurufen, rufen Sie IUIAutomationElement::GetCurrentPropertyValueEx auf.

Das Übergeben von FALSE im parameter ignoreDefaultValue entspricht dem Aufrufen von IUIAutomationElement::GetCachedPropertyValue.

Wenn der Microsoft Benutzeroberflächenautomatisierung Anbieter für das -Element selbst die -Eigenschaft unterstützt, wird der Wert der -Eigenschaft zurückgegeben. Andernfalls wird ein von Benutzeroberflächenautomatisierung angegebenen Standardwert zurückgegeben, wenn ignoreDefaultValueFALSE ist.

Diese Methode gibt einen Fehlercode zurück, wenn die angeforderte Eigenschaft zuvor nicht zwischengespeichert wurde.

Benutzeroberflächenautomatisierung Eigenschaften des Double-Typs unterstützen NaN-Werte (Not a Number). Beim Abrufen einer Eigenschaft des Double-Typs kann ein Client die funktion _isnan verwenden, um zu bestimmen, ob es sich bei der Eigenschaft um einen NaN-Wert handelt.

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)