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

Artigo
03/13/2024

Recupera um valor de propriedade do cache para esse elemento Automação da Interface do Usuário, opcionalmente ignorando qualquer valor padrão.

Sintaxe

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

Parâmetros

[in] propertyId

Tipo: PROPERTYID

O identificador da propriedade . Para obter uma lista de IDs de propriedade, consulte Identificadores de propriedade.

[in] ignoreDefaultValue

Tipo: BOOL

Um valor que especifica se um valor padrão deve ser ignorado se a propriedade especificada não tiver suporte: TRUE se o valor padrão não for retornado ou FALSE se ele for retornado.

[out, retval] retVal

Tipo: VARIANT*

Recebe o valor da propriedade .

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método recupera a propriedade especificada do cache para o elemento Automação da Interface do Usuário. Para recuperar a propriedade atual, chame IUIAutomationElement::GetCurrentPropertyValueEx.

Passar FALSE no parâmetro ignoreDefaultValue é equivalente a chamar IUIAutomationElement::GetCachedPropertyValue.

Se o provedor do Microsoft Automação da Interface do Usuário para o próprio elemento der suporte à propriedade , o valor da propriedade será retornado. Caso contrário, se ignoreDefaultValue for FALSE, um valor padrão especificado por Automação da Interface do Usuário será retornado.

Esse método retornará um código de falha se a propriedade solicitada não tiver sido armazenada em cache anteriormente.

Automação da Interface do Usuário propriedades do tipo duplo dão suporte a valores Não um Número (NaN). Ao recuperar uma propriedade do tipo duplo , um cliente pode usar a função _isnan para determinar se a propriedade é um valor NaN.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uiautomationclient.h (inclua UIAutomation.h)