rexx-things/modules/windows/0ReadMe.first

82 lines
2.8 KiB
Plaintext
Raw Normal View History

2025-03-12 20:50:48 +00:00
Windows ooRexx Example Programs
===============================
The Windows distribution of ooRexx comes with a large number of example
programs that demonstrate programming with ooRexx. Many of these
programs are primarily used to show features of one of the extensions
to ooRexx, such as the ooDialog framework, or the OleObject class.
To make locating a program of interest easier, the example programs are
grouped in subdirectories. This read me file serves as an additional
resource to help document the location of different examples.
samples\
This top-level directory, (the directory containing this read me file,)
contains samples that run unchanged on any platform supported by
ooRexx. Subdirectories, with the exception of samples\native.api,
contain examples that use Windows only extensions.
samples\api\classic\
This directory contains Windows only examples using the old API to
write Rexx extensions. The use of the old API to write new Rexx
extensions is discouraged and the examples may be removed in future
distributions.
samples\misc\
This directory contains miscellaneous Windows only examples that do not
fit well in the other categories.
samples\api\c++\
This directory contains platform independent samples using the C++ API
introduced in ooRexx 4.0.0 to write ooRexx extensions. nMake
compatible make files for the examples are included in this directory.
samples\ole
This directory and its subdirectories contain examples using the
OleObject class, a Windows only class that gives the programmer access
OLE objects.
A few additional samples that combine using the OleObject class and the
ooDialog framework are located under samples\oodialog.
samples\oodialog
This directory and its subdirectories contain all example programs that
use the ooDialog framework. The ooDialog framework allows the Rexx
programmer to easy create programs that have a graphical user
interface.
A number of the programs included with the ooDialog examples
demonstrate combining other Windows only extensions with the ooDialog
framework.
samples\rexxutils
This directory contains example programs that use some of the Windows
only functions from RexxUtils.
Note:
-----
One of the interesting Windows only extensions is the winsystm.cls.
The example programs for this class all make use of the ooDialog
framework. The examples for the winsystm.cls are located at:
samples\oodialog\winsystm\
Two excellent examples of using the OleObject, oleinfo.rex and
sysinfo.rex, are also located under the oodialog subdirectory. These
examples are located at:
samples\oodialog\oleinfo
samples\oodialog\sysinfo