Release 10.1A: OpenEdge Development:
Programming 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 14–1.

> Figure 14–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 Chapter 15, " 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 OpenEdge 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 OpenEdge, 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 OpenEdge 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 14–2.

> Figure 14–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 OpenEdge 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 runtime.

> 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 runtime. (For more information on ActiveX control events, see Chapter 16, " ActiveX Control Support.") You cannot determine the relationship among COM objects from the OpenEdge COM Object Viewer tool. For more information on this, see the documentation provided with each ActiveX control.

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