Method XbpActiveXControl():create() Foundation

Requests system resources for the XbpActiveXControl object.

:create( [<oParent>], [<oOwner>],  ;
         [<aPos>],    [<aSize>],   ;
         [<aPP>],     [<lVisible>] ) --> self
The parent for the XbpActiveXControl can be optionally specified using the parameter <oParent>. By default <oParent> is the active window (the return value of SetAppWindow()).
<oOwner> can be used to set the owner for the XbpActiveXControl. By default <oOwner> is the same as <oParent>.
<aPos> := { nX, nY }
The optional parameter <aPos> can be used to specify the position where the XbpActiveXControl is displayed. By default, this parameter contains the array {0,0}. This specifies the position for the lower left corner of the XbpActiveXControl. The first element contains the x coordinate and the second contains the y coordinate. The coordinates are relative to the coordinate system of <oParent>.
<aSize> := { nXsize, nYsize }
The parameter <aSize> optionally specifies the size of the XbpActiveXControl. <aSize> must be an array containing two elements. The first element specifies the dimension in the x direction (width) and the second element specifies the dimension in the y direction (height). By default this value is the array {0,0}.
A two dimensional array can be specified for <aPresParam>. Refer to Generic presentation parametersfor a detailed explanation.
The parameter <lVisible> determines whether the XbpActiveXControl is visible immediately after the call to the method :create(). By default <lVisible>is .T. (true) and the Xbase Part is displayed after :create() is executed. This default behavior can be suppressed by specifying the value .F. (false) for the parameter <lVisible>. In this case, the object must be explicitly displayed using the :show() method.

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


The method :create() allocates system resources for the internal ActiveX control container. Furthermore, :create() uses AutomationObject:create() to create the ActiveX control identified by the value assigned to the :CLSID instance variable. If the ActiveX control is hosted by a remote COM server, the server name must be assigned to the instance variable :server before the method :create() is called. If a license was supplied by the control vendor for creating instances of the ActiveX control, the license string must be assigned to instance variable :license.


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.