Release 10.1A: OpenEdge Development:
Progress 4GL Reference

> ## Control-Name property

> The component handle to an ActiveX control that has the specified design-time name (`Control-Name`) and that is loaded into the control-frame.

> Data type: COM-HANDLE

> Access: Readable

> Applies to: CONTROL-FRAME widget, COM object

> To return the component handle of the ActiveX control, you provide the design-time name as a property of the control-frame COM object:

>     DEFINE VARIABLE hSpin AS COM-HANDLE.
>     DEFINE VARIABLE hControlFrameCOM AS COM-HANDLE.
>     DEFINE VARIABLE hControlFrame AS WIDGET-HANDLE.

>     /* ... Instantiate the control-frame with hControlFrame
>        and load the Spin control into it ... */

>     hControlFrameCOM = hControlFrame:COM-HANDLE.
>     hSpin = hControlFrameCOM:Spin.

> In this example, Spin is the name of an ActiveX control and is also used as a property to return the handle to that control.

> This is the simplest technique to access an ActiveX control that is loaded in a control frame.

> #### Notes

> - Another way of getting a component handle to an ActiveX control is to access it through the control collection. For more information, see the Controls property entry.

> - References to COM object properties and methods extend the syntax used for referencing widget attributes and methods. For more information, see the "Referencing COM object properties and methods" section.

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095