
Resource Expert: what it is and how to install and use it.


What is the Resource Expert

The Resource Expert is a Delphi expert add-on that is available
as a part of the Delphi Rad Pack.  The expert assists the
programmer in porting existing projects to Delphi by converting
dialog and menu resource scripts intended for use in traditional
Windows applications.  Dialog resources and their contents are
converted to Delphi forms with the analogous controls converted
to Delphi components.


How to install the Resource Expert

The Resource Expert is installed via the Delphi Rad Pack's
Resource Workshop 4.5 install procedure.  Once installed, it is
incorporated into the Delphi component library and is available
as an option on the Delphi Help Menu or via the Experts page of
the Forms Gallery dialog.  Installation of the Resource Expert
files may be installed from within the Windows environment or
from the command line under Windows 95 or Windows NT.


To install the Resource Expert files from within Windows,

  1) Begin the installation procedure for Borland Resource
     Workshop.
  2) On the third dialog, entitled 'Resource Workshop - Resource
     Expert Options', ensure that the 'Install Resource Expert'
     check box is checked.
  3) The 'Install to:' entry indicates the destination directory
     for the Resource Expert files, indicating C:\DELPHI\RCEXPERT
     by default.  Change this entry as needed.
  4) Proceed with the rest of the Resource Workshop installation
     process as normal.

To install the Resource Expert files from the command line, type
the following commands,

  1) MD C:\DELPHI\RCEXPERT
  2) CD C:\DELPHI\RCEXPERT
  3) E:\INSTALL\RW\UNPAQ -X E:\INSTALL\RW\RESEXP.PAK

Note: The last command above assumes that the E: drive is a
CD-ROM drive containing the Rad Pack Installation CD.


Once the installation of the Resource Expert files is completed,
the Delphi Component Library must be recompiled.  To do this,

  1) Load Delphi.
  2) Select Options|Install Components.
  3) Click the Add... button.
  4) When the Add Module dialog appears, enter the full path name
     of the rcexpert.pas file or find the file via the Browse...
     button.
  5) Finally, choose the OK button on the Install Components
     Dialog.



How to use the Resource Expert

To convert a resource script, all source files normally required
to compile the script must be present.  This would include .RC,
.MNU, or .DLG file(s) and any .H or .PAS include files they refer
to.  Resource scripts typically use WINDOWS.H and BWCC.H.  These
files are usually located in directories such as \BC4\INCLUDE or
\BP7\UNITS.  The Resource Expert supports the RC language
extensions defined by Resource Workshop.

Again, the Resource Expert may be invoked via the Help|Resource
Expert menu option or via the Experts page of the Forms Gallery
dialog.  The latter will appear if the 'Use on new form' check
box is checked on the Preferences page of the Environment Options
dialog.

Once the Resource Expert has been invoked, click the 'Next'
button to bypass the page that introduces the expert to the user.
The second page of the expert allows the user to select the
resource scripts to convert.  A number of scripts may be chosen
provided that they all reside in the same directory.  The
particular type of script to view (.RC, .DLG or .MNU) can be
selected via the 'List Files of Type' combo box.  After selecting
the scripts to convert, click the 'Next' button again.  The third
page presents a single 'Include Path' edit box.  Enter the list
of directories containing .H, .INC, or .PAS include files used by
the resource scripts, (if any).  Each directory name should be
separated by a semicolon.  Again, click the 'Next' button to
continue.  On the fourth and final page of the expert, the
'Convert' button appears.  Clicking it begins the actual
conversion process.  If the resources script contain many
dialogs, the 'Show all forms' check box may be un-checked in
order to speed the conversion process and to minimize impact on
Windows system resources.

If a syntax error is encountered during the conversion process,
the erroneous statement will be discarded and conversion will
resume at the next statement or block.  Errors will be noted in
the log file ERRLOG.TXT and displayed in a Delphi editor window.

Once the conversion process is complete, separate forms for each
dialog resource will have been created.  For menu resources, a
simple form containing the converted menu component will have
been created.  If a project was active before the conversion
began, the converted forms are added to the project.  Each form
may now be used and modified as would any Delphi form.
