Vcl.Forms.TApplication.OnActionExecute
Delphi
property OnActionExecute: TActionEvent read FOnActionExecute write FOnActionExecute;
C++
__property System::Classes::TActionEvent OnActionExecute = {read=FOnActionExecute, write=FOnActionExecute};
Properties
Type | Visibility | Source | Unit | Parent |
---|---|---|---|---|
event | public | Vcl.Forms.pas Vcl.Forms.hpp |
Vcl.Forms | TApplication |
Description
Occurs when an action's Execute method is called and its action list has not already handled it.
Use the OnActionExecute event handler to respond when a user invokes actions whose action lists do not have OnExecute event handlers.
If the action list that contains the action does not handle it in an OnExecute event handler, then the action is routed to the application object's ExecuteAction method, which invokes the OnActionExecute event handler. (The application's ExecuteAction method applies to all actions in the application.)
The Handled
parameter of the event handler returns false
by default. If the handler handles the event, it should change Handled
to true
, thereby preventing further attempts to handle the action. When the event handler exits with Handled
set to false
, the action's OnExecute event occurs. If the action remains unhandled after that, the active control's ExecuteAction method is called to allow the action to execute with an identified target. Finally, the active form's ExecuteAction method is called if all other handlers do not handle the action.
Note: You can also respond to this event using the TApplicationEvents component, which allows you to assign an event handler using the IDE.
See Also
- Vcl.Forms.TApplication.OnActionUpdate
- Vcl.Forms.TApplication.ExecuteAction
- System.Classes.TBasicAction.OnExecute
- System.Actions.TContainedActionList.OnExecute
- Vcl.AppEvnts.TCustomApplicationEvents.OnActionExecute
- What Happens When an Action Fires