To port from version 3, 4, 5, or 6 to
version 7 follow these instructions.
NOTE: the most common call we
get regarding porting is solved by making sure to update "PE5API.BAS"
or"PE6API.BAS" or "PE7API.BAS" to "PE8API.BAS" so DLL
declarations point to the correct DLL. Double check any Declare
statements in your project.
Back up your current project.
Run the VBPORT utility from the Start / ProEssentials8
/ VBPORT menu.
Use the [Browse] button to open a VBP or FRM file
belonging to your project.
Click the Start Port button. The file is adjusted
by replacing references to earlier ActiveXs with references to v8 ActiveXs.
The old file is renamed by appending BAK to the file name. The filename
ported is added to the history list to make it easier to keep track of
whats been ported.
Continue opening and porting until all FRM files
are ported as desired.
Now when you open the project in VB, the project
will use ProEssentials v8 ActiveXs.
To port from version 2 or earlier to version 8 follow these instructions.
Manually Porting :
Back up your current project and open project in
Go to any forms which contain ProEssentials OCXs
and delete the controls off of the forms. Make a note of the Name property.
Don't worry about your code, it will remain.
Save the Project.
Go to Components Dialog box and de-select the older OCXs and select the new v8 OCXs. The new v8 OCXs will have "v8"
at the end of their description or have the letter "f" after
the OCX name like PEGOF.
Go back to any forms where the older OCXs were deleted
and reinsert the new v8 OCXs. Rename the controls as needed and save the
You may need to port Class Modules and User Controls manually as needed.
Related to Porting!
Printing Logic Needs Changing!
The addition of clipping logic has the potential to break current ProEssentials
implementations which include custom printing logic. In the process of
porting an application to v8 from much earlier version, you should plan on changing calls of PEresetimage to PEresetimageEx
or disabling clipping by setting DisableClipping
Note that if your project calls PlayMetafile with respect to low-level printing, it should now call the ProEssentials function PEplaymetafile.
Custom Parameter Set now Disabled!
NoCustomParms is now by default
set to TRUE. If desired, set this property back to FALSE.