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

Artigo
03/13/2024

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

Sintaxe

HRESULT SetHwndPropServer(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

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] paProps

Tipo: const MSAAPROPID*

Especifica uma matriz de propriedades que deve ser tratada pelo objeto de retorno de chamada especificado.

[in] cProps

Tipo: int

Especifica o número de propriedades na matriz paProps.

[in] pServer

Tipo: IAccPropServer*

Especifica o objeto de retorno de chamada, que será chamado quando um cliente solicita uma das propriedades substituídas.

[in] annoScope

Tipo: AnnoScope

Pode ser ANNO_THIS, indicando que a anotação afeta o elemento indicado acessível apenas; ou ANNO_CONTAINER, indicando que ele se aplica ao elemento e a seus filhos do elemento imediatos.

Retornar valor

Tipo: HRESULT

Se for bem-sucedido, retornará S_OK.

Retornará E_INVALIDARG se alguma das propriedades na matriz paProps não tiver suporte, se a cadeia de caracteres de identidade não for válida ou se annoScope não for um dos ANNO_THIS ou ANNO_CONTAINER.

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

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 Include 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