Vcl.AppEvnts.TCustomApplicationEvents.OnMessage

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property OnMessage: TMessageEvent read FOnMessage write FOnMessage;

C++

__property Vcl::Forms::TMessageEvent OnMessage = {read=FOnMessage, write=FOnMessage};

Propriétés

Type Visibilité  Source Unité  Parent
event protected
Vcl.AppEvnts.pas
Vcl.AppEvnts.hpp
Vcl.AppEvnts TCustomApplicationEvents

Description

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.

Voir aussi