Compartilhar via


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

Recupera o valor atual de uma propriedade para esse elemento de Automação da Interface do Usuário.

Sintaxe

HRESULT GetCurrentPropertyValue(
  [in]          PROPERTYID propertyId,
  [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.

[out, retval] retVal

Tipo: VARIANT*

Recebe o valor da propriedade .

Valor retornado

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

As propriedades da Automação da Interface do Usuário da Microsoft 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

   
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 (include UIAutomation.h)

Confira também

Conceitual

Getcachedpropertyvalue

GetCurrentPropertyValueEx

IUIAutomationElement

Referência

Visão geral das propriedades de automação da interface do usuário