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

Indique si le conteneur ignore ou accepte les événements du contrôle.

Syntaxe

HRESULT FreezeEvents(
  [in] BOOL bFreeze
);

Paramètres

[in] bFreeze

Indique si le conteneur ignore (TRUE) ou traite maintenant (FALSE) les événements du contrôle.

Valeur retournée

Cette méthode retourne S_OK dans tous les cas.

Notes

Le contrôle n’est pas nécessaire pour arrêter l’envoi d’événements lorsque bFreeze a la valeur TRUE. Toutefois, le conteneur ne va pas les traiter dans ce cas. Si un contrôle dépend du traitement du conteneur, comme pour les événements de demande qui retournent des informations à partir du conteneur, le contrôle doit ignorer l’événement ou mettre en file d’attente l’événement pour l’envoyer ultérieurement lorsque bFreeze a la valeur FALSE.

Notes aux implémenteurs

Comme avec IOleControl::OnAmbientPropertyChange, S_OK est retourné dans tous les cas afin d’empêcher un conteneur de faire des hypothèses sur le comportement d’un contrôle en fonction des valeurs de retour.

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête ocidl.h

Voir aussi

IOleControl