Método IAccPropServices::ClearHwndProps (oleacc.h)
Esse método encapsula SetPropValue, SetPropServer e ClearProps e fornece um ponto de entrada conveniente para os chamadores que estão anotando elementos acessíveis baseados em HWND.
Sintaxe
HRESULT ClearHwndProps(
[in] HWND hwnd,
[in] DWORD idObject,
[in] DWORD idChild,
[in] const MSAAPROPID *paProps,
[in] int cProps
);
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 devem ser redefinidas. Essas propriedades serão revertidas para o comportamento padrão que elas exibiam antes de serem anotadas.
[in] cProps
Tipo: int
Especifica o número de propriedades na matriz paProps.
Retornar valor
Tipo: HRESULT
Se tiver êxito, retornará S_OK, mesmo que as propriedades especificadas nunca tenham sido anotadas no objeto acessível; limpar propriedades já desmarcadas é considerado um sucesso.
Retornará E_INVALIDARG se alguma das propriedades na matriz paProps não tiver suporte.
Pode retornar outros códigos de erro em condições de erro excepcionais, como memória baixa.
Para obter descrições de valores retornados, consulte o método SetPropValue, SetPropServer ou ClearProps correspondente.
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.
Além disso, SetHwndPropStr usa uma cadeia de caracteres Unicode regular como um parâmetro; o chamador não precisa alocar especialmente um BSTR.
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 |