Metodo IUIAutomationElement::GetCachedPropertyValueEx (uiautomationclient.h)

Articolo
03/08/2023

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

Sintassi

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

Parametri

[in] propertyId

Tipo: PROPERTYID

Identificatore della proprietà. Per un elenco degli ID delle 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

Questo metodo recupera la proprietà specificata dalla cache per l'elemento Automazione interfaccia utente. Per recuperare la proprietà corrente, chiamare IUIAutomationElement::GetCurrentPropertyValueEx.

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

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 in precedenza.

Automazione interfaccia utente proprietà del tipo double 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 (include UIAutomation.h)