Compartilhar via

Método IAccPropServices::SetPropValue (oleacc.h)

  • Artigo

Use SetPropValue para identificar o elemento acessível a ser anotado, especificar a propriedade a ser anotada e fornecer um novo valor para essa propriedade.

Se os desenvolvedores de servidores souberem o HWND do elemento acessível que desejam anotar, eles poderão usar um dos seguintes métodos:

Sintaxe

HRESULT SetPropValue(
  [in] const BYTE *pIDString,
  [in] DWORD      dwIDStringLen,
  [in] MSAAPROPID idProp,
  [in] VARIANT    var
);

Parâmetros

[in] pIDString

Tipo: const BYTE*

Identifica o elemento acessível que deve ser anotado.

[in] dwIDStringLen

Tipo: DWORD

Especifica o comprimento da cadeia de caracteres identificada pelo parâmetro pIDString.

[in] idProp

Tipo: MSAAPROPID

Especifica a propriedade do elemento acessível a ser anotada.

[in] var

Tipo: VARIANT

Especifica um novo valor para a propriedade.

Retornar valor

Tipo: HRESULT

Se for bem-sucedido, retornará S_OK.

Retornará E_INVALIDARG se idProp não for uma propriedade com suporte, se var não for um tipo com suporte para essa propriedade ou se a cadeia de caracteres de identidade não for válida.

Pode retornar outros códigos de erro em condições de erro excepcionais, como memória baixa.

Comentários

Consulte a seção de suporte para obter uma lista de propriedades com suporte e seus tipos esperados. Observe que atualmente algumas propriedades têm suporte somente quando um retorno de chamada é usado e não pode ser especificado diretamente usando esse método.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [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 (inclua OleAcc.h Incluir Initguid.h primeiro.)
DLL Oleacc.dll
Redistribuível Active Accessibility 2.0 RDK no Windows NT 4.0 com SP6 e posterior e Windows 98