API:Vcl.AppEvnts.TApplicationEvents.OnMessage
Delphi
property OnMessage;
C++
__property OnMessage;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| event | published | Vcl.AppEvnts.pas Vcl.AppEvnts.hpp |
Vcl.AppEvnts | TApplicationEvents |
Description
Se produit lorsque l'application reçoit des messages Windows.
Vcl.AppEvnts.TApplicationEvents.OnMessage hérite de Vcl.AppEvnts.TCustomApplicationEvents.OnMessage. Tout le contenu en-dessous de cette ligne se réfère à Vcl.AppEvnts.TCustomApplicationEvents.OnMessage.
Se produit lorsque l'application reçoit des messages Windows.
L'événement OnMessage permet d'intercepter tout ou partie des messages Windows expédiés à toutes les fenêtres de l'application. L'événement OnMessage se produit quand une application reçoit un message Windows. OnMessage ne reçoit que des messages envoyés à la file d'attente des messages, et non ceux envoyés directement à l'aide de la fonction SendMessage de l'API Windows.
La création d'un gestionnaire d'événement OnMessage dans une application permet à des gestionnaires d'événements de répondre à d'autres messages que ceux déclarés dans les événements de TApplication. Si une application n'a pas de gestionnaire spécifique pour un message entrant, le message est distribué à la fenêtre à laquelle il est destiné et Windows traite les messages.
Avertissement : Attention : Des milliers de messages transitent par seconde dans cet événement. Soyez prudent en codant ce gestionnaire car il affecte les performances de toute l'application.
Conseil : Appelez la méthode CancelDispatch à partir d'un gestionnaire d'événement OnMessage pour éviter que l'application n'envoie l'événement à n'importe quel autre objet d'événements d'application.