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

  • Artigo

Esse método encapsula SetPropValue, fornecendo um ponto de entrada mais conveniente para os chamadores que estão anotando elementos acessíveis baseados em HWND.

Sintaxe

HRESULT SetHwndPropStr(
  [in] HWND       hwnd,
  [in] DWORD      idObject,
  [in] DWORD      idChild,
  [in] MSAAPROPID idProp,
  [in] LPCWSTR    str
);

Parâmetros

[in] hwnd

Tipo: HWND

Identifica o elemento acessível que deve ser anotado. Isso substitui a cadeia de caracteres de identidade.

[in] idObject

Tipo: DWORD

Identifica o elemento acessível que deve ser anotado. Isso substitui a cadeia de caracteres de identidade.

[in] idChild

Tipo: DWORD

Identifica o elemento acessível que deve ser anotado. Isso substitui a cadeia de caracteres de identidade.

[in] idProp

Tipo: MSAAPROPID

Especifica qual propriedade desse elemento acessível deve ser anotada.

[in] str

Tipo: LPCWSTR

Especifica um novo valor para aquela propriedade.

Retornar valor

Tipo: HRESULT

Se for bem-sucedido, retornará S_OK.

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

Comentários

Usando esse método, o chamador não precisa obter uma cadeia de caracteres de identidade; ele pode especificar os parâmetros hwnd, idObject e idChild diretamente.

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

Confira também

ClearHwndProps

Iaccpropservices

SetHwndProp

SetHwndPropServer

SetPropValue