Vcl.AppEvnts.TCustomApplicationEvents.OnMessage

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property OnMessage: TMessageEvent read FOnMessage write FOnMessage;

C++

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

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
event protected
Vcl.AppEvnts.pas
Vcl.AppEvnts.hpp
Vcl.AppEvnts TCustomApplicationEvents

Beschreibung

Wird ausgelöst, wenn die Anwendung eine Windows-Botschaft erhält.

Mithilfe von OnMessage können Sie einige oder alle der für die Anwendung bestimmten Windows-Botschaften abfangen. Das Ereignis wird ausgelöst, sobald die Anwendung eine Botschaft erhält. OnMessage kann nur für Botschaften in der Warteschlange verwendet werden, nicht aber für Botschaften, die direkt mit der API-Funktion SendMessage gesendet werden.

In der Ereignisbehandlungsroutine für OnMessage können Sie auch auf Botschaften reagieren, die nicht in den Ereignissen von TApplication deklariert sind. Wenn für eine eingehende Botschaft keine spezielle Behandlungsroutine vorhanden ist, wird sie an das Zielfenster gesendet und anschließend von Windows behandelt.

Warnung:  In jeder Sekunde werden möglicherweise Tausende von Botschaften gesendet. Implementieren Sie diese Routine so effektiv wie möglich, damit die Geschwindigkeit der Anwendung nicht darunter leidet.

Tip:  In der Behandlungsroutine OnMessage können Sie durch einen Aufruf der Methode CancelDispatch verhindern, dass das Ereignis an andere Ereigniskomponenten weitergegeben wird.

Siehe auch

Codebeispiele