Método IOleControl::FreezeEvents (ocidl.h)

Indica se o contêiner está ignorando ou aceitando eventos do controle.

Sintaxe

HRESULT FreezeEvents(
  [in] BOOL bFreeze
);

Parâmetros

[in] bFreeze

Indica se o contêiner ignorará (TRUE) ou agora processará eventos (FALSE) do controle.

Valor retornado

Esse método retorna S_OK em todos os casos.

Comentários

O controle não é necessário para parar de enviar eventos quando bFreeze for TRUE. No entanto, o contêiner não vai processá-los nesse caso. Se um controle depender do processamento do contêiner , como ocorre com eventos de solicitação que retornam informações do contêiner , o controle deverá descartar o evento ou enfileirar o evento para enviar posteriormente quando bFreeze for FALSE.

Observações aos implementadores

Assim como acontece com IOleControl::OnAmbientPropertyChange, S_OK é retornado em todos os casos para impedir que um contêiner crie suposições sobre o comportamento de um controle com base em valores retornados.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ocidl.h

Confira também

Iolecontrol