Método IUIAutomationElement::GetCachedPropertyValueEx (uiautomationclient.h)

Artículo
03/13/2024

Recupera un valor de propiedad de la memoria caché de este elemento Automatización de la interfaz de usuario y, opcionalmente, omite cualquier valor predeterminado.

Sintaxis

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

Parámetros

[in] propertyId

Tipo: PROPERTYID

Identificador de la propiedad. Para obtener una lista de identificadores de propiedad, vea Identificadores de propiedad.

[in] ignoreDefaultValue

Tipo: BOOL

Valor que especifica si se debe omitir un valor predeterminado si no se admite la propiedad especificada: TRUE si no se va a devolver el valor predeterminado o FALSE si se va a devolver.

[out, retval] retVal

Tipo: VARIANT*

Recibe el valor de la propiedad .

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método recupera la propiedad especificada de la memoria caché del elemento Automatización de la interfaz de usuario. Para recuperar la propiedad actual, llame a IUIAutomationElement::GetCurrentPropertyValueEx.

Pasar FALSE en el parámetro ignoreDefaultValue equivale a llamar a IUIAutomationElement::GetCachedPropertyValue.

Si el proveedor de Microsoft Automatización de la interfaz de usuario para el propio elemento admite la propiedad , se devuelve el valor de la propiedad . De lo contrario, si ignoreDefaultValue es FALSE, se devuelve un valor predeterminado especificado por Automatización de la interfaz de usuario.

Este método devuelve un código de error si la propiedad solicitada no se ha almacenado en caché previamente.

Automatización de la interfaz de usuario propiedades del tipo doble admiten valores No un número (NaN). Al recuperar una propiedad del tipo double , un cliente puede usar la función _isnan para determinar si la propiedad es un valor NaN.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista, Windows XP con SP3 y Platform Update para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	uiautomationclient.h (include UIAutomation.h)