Hi there,

if working with the Windows version of Object Rexx it is very worthwhile to use Object Rexx for remote controlling Windows applications via ActiveX/OLE-automation.

However, many times it is very hard to find the documentation about the interfaces to such Windows programs. This is where the utility "rgf_oleinfo.hta" comes into play: this is a set of Object Rexx programs (one embedded in HTML) which allows interrogating such ActiveX/OLE-programs and renders the results as HTML files. This has the benefit, that one is able to print the results with the help of the browser, thereby gaining a printed documentation of those interfaces. Something, at least I like to have myself.

If you want to see how such a rendering may look like, here is a rendering about the interfaces the Microsoft Internet Explorere (MSIE) publishes:

Should the layout be improvable from your point of view, then mostlikely it is sufficient for you to merely change/adapt the supplied cascading style sheet (CSS), a text file named "rgf_oleinfo.css". CSS even allow for defining formatting rules depending on the media, e.g. screen and printer. So, it may be worthwhile to look into this technology (cf. http://www.w3c.org).

First-time users: just get "Open Object Rexx" (ooRexx, went opensource in the spring of 2005) from http://www.ooRexx.org and install it.

IBM Object REXX users: You need Object Rexx at level 2.1.2, the update (available since 2002-12)can be downloaded via the "Support download" section at: http://www-3.ibm.com/software/ad/obj-rexx/support.html

The Object Rexx utilities (all source code given) needed are stored in the following archive: http://wi.wu-wien.ac.at/rgf/rexx/orx08/orx8_200505.zip

their documentation can be found in: http://wi.wu-wien.ac.at/rgf/rexx/orx08/Part1.pdf and http://wi.wu-wien.ac.at/rgf/rexx/orx08/Part2.pdf.

The Object Rexx programs for querying the ActiveX/OLE-interfaces with Object Rexx are located in the archive: http://wi.wu-wien.ac.at/rgf/rexx/orx15/rgf_oleinfo.zip

The presentation can be found here: http://wi.wu-wien.ac.at/rgf/rexx/orx15/2004_orx15_ORX-Win-2.pdf
The article can be found here: http://wi.wu-wien.ac.at/rgf/rexx/orx15/2004_orx15_orx-win.pdf


Unzip the archives (make sure PATH points to the extracted utility programs from the orx8_200505.zip archive).


===> "rgf_oleinfo.hta"


===> "rgf_oleconstants.rex"

Utility to create an Object Rexx ::requires-file for OLE constants.

usage: rgf_oleconstants appid/clsid [outfile]


   rexx rgf_oleconstants InternetExplorer.Application msie_const.rex

... then, whenever you need to access MSIE-constants, then merely use

   ::requires msie_const.rex

and refer to them e.g. like


hint: one may use any combinations of such created files, as they all use the same directory object to map the constant names to their values (ie. you may ::requires as many OLE-constant Rexx-files as you need (e.g. the constants of InternetExplorer, Excel, Eudora etc.)

===> "rgf_oleinfo.rex"

Utility (command line & function) to create HTML-files about OLEObjects on the fly.

Additional infos to the supplied utility "rgf_oleinfo.rex":

===> "rgf_oleinfo.css"

Cascading Stylesheet which governs the formatting of the resulting HTML file and the HTA-user interface. Adjust to your needs, if necessary.

===> "rgf_oleinfo.wsc"

COM-class which allows "rgf_oleinfo" to be used from any language under Windows (e.g. C++, Visual Basic, JScript, Object Rexx, ...), which is able to use OLE/ActiveX automation

Please post any comments, problems, qeustions, etc. here in news:comp.lang.rexx

---rony 2005-10-28 (Show contents of this directory.)