Try OpenEdge Now
skip to main content
ABL Reference
Handle Attributes and Methods Reference : ADD-EVENTS-PROCEDURE( ) method
 

ADD-EVENTS-PROCEDURE( ) method

(Windows only; Graphical interfaces only)
Adds an external procedure to the list that the AVM searches for event procedures to handle ActiveX control events.
Return type: LOGICAL
Applies to: CONTROL-FRAME widget

Syntax

ADD-EVENTS-PROCEDURE ( procedure-handle )
procedure-handle
A handle to a persistent procedure or an otherwise active procedure on the call stack.
By default, the AVM searches the external procedure that created the current control-frame for the event procedure to handle an ActiveX control event. This method allows you to specify alternative procedure (.p and .w) files to search for the event handler.
When the AVM receives an ActiveX event, it searches for the event handler in order of the most recent procedure added to the search list and ends the search with the external procedure that created the control-frame. You can override an existing procedure by adding a different one to the search list. The AVM always uses the event handler in the most recently added procedure.
If the method succeeds in adding the procedure to the list, it returns TRUE. Otherwise, it returns FALSE.