IUIAutomationElement::GetCurrentPropertyValue Method

  • Article

Retrieves the current value of a property for this UI Automation element.

Syntax

HRESULT GetCurrentPropertyValue(      
    PROPERTYID propertyId,
    VARIANT *retVal
);

Parameters

  • propertyId
    [in] The identifier of the property. For a list of property IDs, see Property Identifiers.
  • retVal
    [out, retval] The address of a variable that receives the value of the property.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

Microsoft UI Automation properties of the double type support Not a Number (NaN) values. When retrieving a property of the double type, a client can use the _isnan function to determine whether the property is a NaN value.

See Also

IUIAutomationElement, IUIAutomationElement::GetCachedPropertyValue, IUIAutomationElement::GetCurrentPropertyValueEx, UI Automation Properties Overview