Vcl.AppEvnts.TCustomApplicationEvents.OnActionUpdate

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property OnActionUpdate: TActionEvent read FOnActionUpdate write FOnActionUpdate;

C++

__property System::Classes::TActionEvent OnActionUpdate = {read=FOnActionUpdate, write=FOnActionUpdate};

Eigenschaften

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

Beschreibung

Wird ausgelöst, wenn die Methode Update einer Aktion aufgerufen wird und deren Aktionsliste das Ereignis nicht bereits behandelt hat.

Verwenden Sie die Ereignisbehandlungsroutine OnActionUpdate zur Aktualisierung der Eigenschaften einer Aktion, wenn sich die Anwendung im Leerlauf befindet und die Aktion von ihrer Aktionsliste nicht durch eine OnUpdate-Ereignisbehandlungsroutine behandelt wird. OnActionUpdate wird nach dem Ereignis OnIdle der Anwendung ausgelöst.

Wenn in der Aktionsliste, in der die Aktion enthalten ist, keine OnUpdate-Ereignisbehandlungsroutine gefunden wird, wird die Aktion an die Methode UpdateAction des Anwendungsobjekts verwiesen, welche die Ereignisbehandlungsroutine OnActionUpdate aufruft. Die Ereigniskomponente fängt dieses Ereignis ab und behandelt es in seiner OnActionUpdate-Behandlungsroutine.

Der Parameter Handled der Ereignisbehandlungsroutine gibt standardmäßig false zurück. Wenn das Ereignis durch die Behandlungsroutine behandelt wird, sollte true zurückgeliefert werden, um weitere Versuche zur Behandlung der Aktion zu verhindern. Wenn Handled beim Beenden der Routine den Wert false hat, wird das Ereignis an die anderen Objekte übergeben, die Anwendungsereignisse behandeln. Anschließend wird das Ereignis OnUpdate der Aktion ausgelöst. Bleibt die Aktion auch danach unbehandelt, wird die Methode UpdateAction des aktiven Steuerelements aufgerufen, damit die Aktion für ein identifiziertes Ziel ausgeführt werden kann. Wenn die Aktion von keiner Ereignisbehandlungsroutine behandelt wird, erfolgt ein Aufruf der Methode UpdateAction des aktiven Formulars.

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

Siehe auch

Codebeispiele