Vcl.AppEvnts.TApplicationEvents.OnMessage

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property OnMessage: TMessageEvent read FOnMessage write FOnMessage;

C++

__property OnMessage;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
event published
Vcl.AppEvnts.pas
Vcl.AppEvnts.hpp
Vcl.AppEvnts TApplicationEvents

Beschreibung

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

Vcl.AppEvnts.TApplicationEvents.OnMessage erbt von Vcl.AppEvnts.TCustomApplicationEvents.OnMessage. Der folgende Inhalt bezieht sich auf Vcl.AppEvnts.TCustomApplicationEvents.OnMessage.

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