Freigeben über


IUIAutomationElement::GetCurrentPropertyValue-Methode (uiautomationclient.h)

Ruft den aktuellen Wert einer Eigenschaft für dieses UI Automation-Element ab.

Syntax

HRESULT GetCurrentPropertyValue(
  [in]          PROPERTYID propertyId,
  [out, retval] VARIANT    *retVal
);

Parameter

[in] propertyId

Typ: PROPERTYID

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

[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

Microsoft UI Automation-Eigenschaften des doppelten Typs unterstützen Not a Number (NaN)-Werte. 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

   
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)

Siehe auch

Konzept

Getcachedpropertyvalue

GetCurrentPropertyValueEx

IUIAutomationElement

Referenz

Übersicht über die Benutzeroberflächenautomatisierungs-Eigenschaften