Method XbpActiveXControl():activate() Foundation

Trigger the standard action associated with an ActiveX control.

:activate() --> self

This method returns the object executing the method (self).


The method :activate() activates the standard action defined for an Active control. :activate() also closes a modal dialog or XbpCrt window if the ActiveX control is defined as the form's default or cancel control. More info on modal dialog windows can be found under method XbpDialog:showModal(), and the instance variables :default and :cancel.

:activate() is the default event handler method for the xbeP_Activate event. If the ESC or ENTER key is pressed in a modal dialog, the form's keyboard handler sends xbeP_Activate to the form's default or cancel control. The method :activate() is called automatically to handle the event.

The xbeP_Activate event and its corresponding event handler :activate() is used internally by the parent form and the ActiveX control. Both should not be used for implementing event processing inside an Xbase++ application. Instead, applications should use the event callback slot defined for the control's standard event. xbeP_Activate is only generated for ActiveX controls that have the OLECTRL_ACTSLIKEBUTTON flag set in their :controlFlags instance variable. Also, calling :activate() has no effect unless the ActiveX control behaves like a push button.


If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.