Product Information > JADE Development Environment User’s Guide > Chapter 16 - Importing External Components > Importing ActiveX Control Libraries and Automation Libraries

Importing ActiveX Control Libraries and Automation Libraries

ActiveX type libraries are available for import only after they have been registered in the operating system registry of the workstation into which they are being imported, under the key HKEY_CLASSES_ROOT\typelib. For details, see "Registering an ActiveX Server", later in this chapter.

For details about the default names generated by the ActiveX Import Wizard, see "Default Names" under "ActiveX Default Values and Considerations", in Chapter 4 of the JADE External Interface Developer's Reference.

Before you can use an ActiveX type library registered in the operating system registry for your workstation, you must first import the definition of the ActiveX object into JADE. The ActiveX object definitions are contained in type libraries.

A type library can be a stand-alone file, usually with a .tlb extension, or it can be imbedded within the executable module (that is, the executable or library file). A type library can describe one object or more typically, multiple objects.

The ActiveX Import Wizard is a wizard-style dialog that consists of five steps, each represented by a sheet of the dialog. Use the Next > and < Back buttons to navigate forwards or backwards through the steps. No step is enabled until the previous step has been completed.

If a parameter does not specify [in], [out], or [in, out] and it is a reference when you import an ActiveX type library, JADE sets the parameter to [in, out].

To import an ActiveX type library

  1. Select the ActiveX command from the Components menu. The Import submenu is then displayed.

  2. Select the type library that you want to import, as follows.

    Both the Control Library and the Automation Library submenu commands invoke the ActiveX Import Wizard. The differences between these commands are the libraries that are displayed in the initial list of ActiveX type libraries and some minor differences in the code that is generated.

    In addition, ActiveX control objects are generated as subclasses of the ActiveXControl class and ActiveX automation objects are generated as subclasses of the ActiveXAutomation class.

The ActiveX Import Wizard is then displayed.

The ActiveX Import Wizard systematically guides you through the import process. When all of the information has been gathered, the wizard generates all of the required classes, properties, and methods that you need to access the ActiveX object from JADE.