Método IAccPropServices::SetHwndPropServer (oleacc.h)
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 |