Visit Gigasoft's Web Site
ProEssentials v8 Help

Chapter 3: ActiveX Porting from Earlier Version

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 design mode. 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 project.

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 to TRUE.


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.