Progress
External Program
Interfaces


Locating Objects In the Viewer

The top listbox label in the Viewer changes depending on whether you open an Automation Server Type Library or an ActiveX control Type Library. For Automation Servers, the top listbox is Automation Objects. For ActiveX controls it is Controls.

Automation Objects

For Automation Servers, the Viewer displays all createable Automation objects in the Automation Objects listbox, as shown in Figure 7–1.

Figure 7–1: Automation Objects In the COM Object Viewer

In COM, a createable Automation object has an identifier known as a Program Identifier (ProgID in the registry). This identifier is the expression that you use to identify the Automation object in the 4GL CREATE Automation Object statement (see ActiveX Automation Support."). The Automation Objects listbox lists the ProgID of each createable Automation object followed by the corresponding COM object (Related COM Objects).

When you select an item in the Automation Objects listbox, a Progress Syntax editbox at the bottom of the window shows sample 4GL syntax for creating it. You can cut and paste this syntax into a 4GL procedure.

The Viewer lists all COM objects that are available from the Automation Server to an Automation Controller, like Progress, in the COM Objects listbox. In general, only a small number of Automation objects are createable. You then use the properties and methods on these COM objects to access the other COM objects listed for the Server. You cannot determine the relationship among COM objects from the Progress COM Object Viewer tool. For more information on this, see the documentation provided with each Automation Server.

ActiveX Controls

For ActiveX controls, the Viewer displays the name of the control in the Controls listbox that is selectable as an OCX in the AppBuilder, as shown in Figure 7–2.

Figure 7–2: ActiveX Controls In the COM Object Viewer

The listed control name is the OCX name (not the control-frame name) that the AppBuilder displays for the control when you select and insert it in a design window. This name is followed by the names of corresponding COM objects (Related COM Objects).

When you select an item in the Controls listbox (not shown selected), no syntax appears in the Progress Syntax editbox at the bottom of the window. This is because the AppBuilder generates all required syntax for creating an ActiveX control in your application at run time.

The viewer lists all COM objects that are available to Progress with this control in the COM Objects listbox.

In general, only one listed object is available in the AppBuilder at design time, the ActiveX control, itself. You then use the properties, methods, and events on the ActiveX control to access the other COM objects listed in the COM Objects listbox at run time. (For more information on ActiveX control events, see ActiveX Control Support.") You cannot determine the relationship among COM objects from the Progress COM Object Viewer tool. For more information on this, see the documentation provided with each ActiveX control.


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