Metodo IUIAutomationElement::GetCurrentPropertyValueEx (uiautomationclient.h)

Articolo
08/26/2023

Recupera un valore della proprietà per questo elemento Automazione interfaccia utente, ignorando facoltativamente qualsiasi valore predefinito.

Sintassi

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

Parametri

[in] propertyId

Tipo: PROPERTYID

Identificatore della proprietà. Per un elenco di ID proprietà, vedere Identificatori di proprietà.

[in] ignoreDefaultValue

Tipo: BOOL

Valore che specifica se un valore predefinito deve essere ignorato se la proprietà specificata non è supportata: TRUE se il valore predefinito non deve essere restituito o FALSE se deve essere restituito.

[out, retval] retVal

Tipo: VARIANT*

Riceve il valore della proprietà.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il passaggio di FALSE nel parametro ignoreDefaultValue equivale a chiamare IUIAutomationElement::GetCurrentPropertyValue.

Se il provider microsoft Automazione interfaccia utente per l'elemento stesso supporta la proprietà, viene restituito il valore della proprietà. In caso contrario, se ignoreDefaultValue è FALSE, viene restituito un valore predefinito specificato da Automazione interfaccia utente.

Questo metodo restituisce un codice di errore se la proprietà richiesta non è stata memorizzata nella cache.

Automazione interfaccia utente proprietà del tipo doppio supportano i valori Not a Number (NaN). Quando si recupera una proprietà del tipo double , un client può usare la funzione _isnan per determinare se la proprietà è un valore NaN.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista, Windows XP con SP3 e Platform Update per Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008, Windows Server 2003 con SP2 e Platform Update per Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationclient.h (includere UIAutomation.h)