Compartilhar via


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

Esse método encapsula ClearProps e fornece um ponto de entrada conveniente para os chamadores que estão anotando elementos acessíveis baseados em HMENU.

Sintaxe

HRESULT ClearHmenuProps(
  [in] HMENU            hmenu,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

Parâmetros

[in] hmenu

Tipo: HMENU

Identifica o elemento acessível baseado em HMENU a ser anotado.

[in] idChild

Tipo: DWORD

Especifica a ID do filho do elemento acessível.

[in] paProps

Tipo: const MSAAPROPID*

Especifica uma matriz de propriedades a serem 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 outros parâmetros e valores retornados, consulte o método ClearProps .

Comentários

Usando esse método, o chamador não precisa obter uma cadeia de caracteres de identidade; ele pode especificar os parâmetros hmenu 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

ClearProps

Iaccpropservices

SetHmenuProp

SetHmenuPropServer

SetHmenuPropStr