CreateCtlWindow Method

Description

Creates the ImagXpress Control Window.

Syntax

Visual Basic
Public Sub CreateCtlWindow( _ ByVal hParent As Long, _ ByVal left As Long, _ ByVal top As Long, _ ByVal width As Long, _ ByVal height As Long _ )

Parameters

hParent: The handle of the parent Window of the ImagXpress object.
left: The left position of the controls Window with respect to the parent Window.
top: The top position of the controls Window with respect to the parent Window.
width: The width of the controls Window in pixels.
height: The height of the controls Window in pixels.

Remarks

When an ImagXpress control is instantiated as an ActiveX control, the controls Window is automatically created and destroyed by the ActiveX framework. It is not necessary to use the CreateCtlWindow and DestroyCtlWindow Methods when using the ActiveX component.

When ImagXpress is used as a COM object, the ActiveX framework is not invoked, therefore the COM object is instantiated without a Window. If a Window is desired, the CreateCtlWindow method must be invoked to create the objects window. Each call to CreateCtlWindow must be paired with a call to DestroyCtlWindow prior to destroying the object.

When using the ImagXpress COM object in VC++ or CBuilder with the supplied include files in the VC++ sample directory, CreateCtlWindow gets called in the objects constructor in ImagXpressEvents10.h and the Window gets destroyed in the objects destructor.

When using the ImagXpress COM object in other environments, you must explicitly invoke CreateCtlWindow and DestroyCtlWindow.