Método IAccessible::get_accValue (oleacc.h)

O método IAccessible::get_accValue recupera o valor do objeto especificado. Nem todos os objetos possuem um valor.

Sintaxe

HRESULT get_accValue(
  [in]          VARIANT varChild,
  [out, retval] BSTR    *pszValue
);

Parâmetros

[in] varChild

Tipo: VARIANT

Especifica se as informações de valor recuperadas pertencem ao objeto ou a um dos elementos filho do objeto. Esse parâmetro é CHILDID_SELF (para obter informações sobre o objeto) ou uma ID filho (para obter informações sobre o elemento filho do objeto). Para obter mais informações sobre como inicializar a estrutura VARIANT, consulte Como as IDs filho são usadas em parâmetros.

[out, retval] pszValue

Tipo: BSTR*

Endereço do BSTR que recebe uma cadeia de caracteres localizada que contém o valor atual do objeto.

Retornar valor

Tipo: HRESULT

Se for bem-sucedido, retornará S_OK.

Se não for bem-sucedido, retornará um dos valores na tabela a seguir ou outro código de erro COM padrão. Os servidores retornam esses valores, mas os clientes devem sempre marcar parâmetros de saída para garantir que eles contenham valores válidos. Para obter mais informações, consulte Verificando valores retornados do IAccessible.

Erro Descrição
DISP_E_MEMBERNOTFOUND
O objeto não dá suporte a essa propriedade.
E_INVALIDARG
Um argumento não é válido.

Comentários

Valores numéricos retornados da barra de rolagem e objetos acessíveis da barra de rastreamento indicam porcentagens. Eles são inteiros entre zero (0) e cem (100), inclusive, mas também podem ser um intervalo limitado, por exemplo, entre um (1) e dezesseis (16). Além disso, alguns objetos de barra de rolagem e trackbar retornam cadeias de caracteres que correspondem a configurações como tamanho da tela ou segurança da Internet.

Observação para desenvolvedores de servidores: Localize a cadeia de caracteres retornada dessa propriedade.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho oleacc.h
Biblioteca Oleacc.lib
DLL Oleacc.dll
Redistribuível Active Accessibility 1.3 RDK no Windows NT 4.0 com SP6 e posterior e Windows 95

Confira também

Iaccessible

Propriedade Value