IUIAutomationElement：：GetCurrentPropertyValueEx 方法 (uiautomationclient.h)

發行項
03/13/2024

擷取這個使用者介面自動化項目的屬性值，並選擇性地忽略任何預設值。

語法

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

參數

[in] propertyId

類型： PROPERTYID

屬性的標識碼。如需屬性識別碼的清單，請參閱屬性標識碼。

[in] ignoreDefaultValue

類型： BOOL

值，指定如果不支援指定的屬性，是否應該忽略預設值：如果未傳回預設值，則為 TRUE ，如果傳回預設值，則為 FALSE 。

[out, retval] retVal

類型： VARIANT*

接收屬性值。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

備註

在ignoreDefaultValue 參數中傳遞 FALSE 相當於呼叫 IUIAutomationElement：：GetCurrentPropertyValue。

如果專案本身的 Microsoft 使用者介面自動化提供者支援屬性，則會傳回屬性的值。否則，如果ignoreDefaultValue為 FALSE，則會傳回使用者介面自動化所指定的預設值。

如果先前未快取要求的屬性，這個方法會傳回失敗碼。

雙精度浮點數類型的使用者介面自動化屬性支援「數位」 (NaN) 值。擷取 雙精度浮 點類型的屬性時，用戶端可以使用 _isnan 函式來判斷屬性是否為 NaN 值。

規格需求

需求	值
最低支援的用戶端	Windows 7、Windows Vista sp2 和 Platform Update for Windows Vista、Windows XP with SP3 和 Platform Update for Windows Vista [僅限桌面應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [僅限桌面應用程式]
目標平台	Windows
標頭	uiautomationclient.h (包含 UIAutomation.h)