PLEASE READ!!!

Starting with version 1.5 of the templates, if you are using ProPath in a Multi-DLL app you no longer set most of the options in global template of the main EXE.

Instead you set them in the Data DLL.  This is necessary so that ProPath can work it's magic before the other initialization code in the Data DLL (such as FM3).

 

As a result, the tabs on the global template that show these options will be hidden when it is added to an EXE (if the EXE is a marked as part of a Multi-DLL solution).

Likewise the tabs on the global template that show these options will be displayed when it is added to a DLL (if the DLL is a marked as the Data DLL of a Multi-DLL solution).

 

One thing to be aware of:

The ProPath code in the data DLL executes BEFORE the MAIN procedure in the application.  Normally this causes no problems at all, however we have discovered on potential problem.

You can not open a FILE DIALOG on the ProPath window (we have tried all of them, from the native Clarion one to a direct call with the Windows API).  If you do, then the cursor will go to a BUSY indicator and the program will hang.

 

This means that in order to prevent this from happening, ProPath will automatically HIDE the FILE DIALOG buttons on the WnSelectPath procedure and also on the WnModifyDataSet procedure IF they are called from the Data DLL during startup.

 

If these procedures are called after MAIN is opened (from the menu or a button with the #CODE template), then the flag that hides the button is reset and the procedure works normally as expected.

 

So what does this mean to you?

 

The only feature that is missing is the one that allows the user to browse for a different location than the one you suggest with the templates on WnSelectPath or the dialog buttons that select a different path (or browse for a dataset) in the WnModifyDataSet procedure.  The user can type a different path in manually or use the suggested paths with no problems at all.  If that is not suitable to them, then they only need to select that feature again from your menu and the FILE DIALOG will be available to them.

 

 

UPGRADING FROM AN EARLIER VERSION

If you had already used ProPath in a Multi-DLL app before version 1.5, you will need to uncheck the options on the global template of the main EXE before adding them to the Data DLL.

 

To do this, you simply select the option on the main EXE global extension to indicate that the app is a Single EXE.  This will unhide the tabs and make it possible for you to uncheck (or copy values for use in the Data DLL).  Then after you have disabled the settings, just select the option that says that the app is a part of a Multi-DLL app.  This will again hide the tabs.

 

Then you can add the global extension to the Data DLL and select the option to indicate that it is the Data DLL.  This will unhide the tabs and make it possible for you to set the relevant ProPath settings.

 

Our apologies to anyone who has to move settings to the Data DLL.  This change came up after the earlier release as a result of advanced testing with CapeSoft's FM3 in a Multi-DLL app.