Compartilhar via

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

  • Artigo

Os servidores usam ClearProps para restaurar valores padrão para propriedades de elementos acessíveis que haviam anotado anteriormente.

Se os servidores souberem o HWND do objeto que desejam limpar, eles poderão usar IAccPropServices::ClearHwndProps.

Sintaxe

HRESULT ClearProps(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

Parâmetros

[in] pIDString

Tipo: const BYTE*

Identifique o elemento acessível que deve ser ter a anotação cancelada.

[in] dwIDStringLen

Tipo: DWORD

Comprimento de pIDString.

[in] paProps

Tipo: const MSAAPROPID*

Especifique 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

Tamanho da 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.

Retorna 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 insuficiente.

Comentários

Consulte a seção de suporte para obter uma lista de propriedades com suporte e seus tipos esperados.

Limpar a anotação de uma propriedade fará com que todos os recursos associados sejam liberados. Se um servidor de propriedades de retorno de chamada tiver sido usado (consulte SetPropServer), ele será liberado.

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