Compartilhar via


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

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

Sintaxe

HRESULT GetCurrentPropertyValueEx(
  [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 deve ser retornado ou FALSE se ele deve ser 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

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

Se o microsoft Automação da Interface do Usuário provedor para o elemento em si 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 (include UIAutomation.h)

Confira também

Conceitual

GetCachedPropertyValueEx

Getcurrentpropertyvalue

IUIAutomationElement

Referência

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