Método IAccessible::p ut_accValue (oleacc.h)

O método IAccessible::p ut_accValue define o valor do objeto especificado. Nem todos os objetos possuem um valor.

Sintaxe

HRESULT put_accValue(
  [in] VARIANT varChild,
  [in] BSTR    szValue
);

Parâmetros

[in] varChild

Tipo: VARIANT

Especifica se as informações de valor que estão sendo definidas pertencem ao objeto ou a um dos elementos filho do objeto. Esse parâmetro é CHILDID_SELF (para definir informações sobre o objeto) ou uma ID filho (para definir 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.

[in] szValue

Tipo: BSTR

Uma cadeia de caracteres localizada que contém o valor 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 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

O método IAccessible::p ut_accValue tem suporte para alguns elementos de interface do usuário (geralmente editam controles). Para elementos de interface do usuário que não dão suporte a esse método, métodos específicos de controle são usados. Para obter mais informações, consulte Referência de elemento de interface do usuário com suporte.

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