Installation notes

• If you are using XFRX with source codes, please note that four header (*.H) files have been added:
  • xfrx.h
  • reportlisteners.h
  • reportlisteners_locs.h
  • foxpro_reporting.h
• Before compiling XFRX, make sure you define the VFP version you are using in xfrx.h. (Please find more information about differences between XFRX for VFP 8 and XFRX for VFP 9 in the Developer's guide at http://www.eqeus.com/xfrxmanual.php).
• In order to save reports as pictures or to use the printing feature, XFRX requires two additional libraries to be installed:
  • msvcr71.dll - Microsoft Visual C++ 7.1 runtime library and is distributed with VFP 9.0. If it is not installed on your pc, you can download it from http://www.eqeus.com/files/msvcr71.zip.
  • gdiplus.dll - This dll is included in WindowsXP as well as VFP 8.0 and VFP 9.0. If it is not available on your pc, you can download it from http://www.microsoft.com/msdownload/platformsdk/sdkupdate/psdkredist.htm.

If you are not planning to export reports as pictures or print, you can download a special version of XFRXLIB.FLL (http://www.eqeus.com/files/xfrxlib-nogdiplus.zip ), which doesn't require the two dlls mentioned above. This version is also available in the nogdip subdirectory of the evaluation and commercial package.

• OpenOffice Writer document format is now supported.
  OpenOffice is using the OASIS Open Document Format for Office Applications, which is also supported by a variety of other office applications including StarOffice, KOffice, and IBM Workplace. XFRX generates the file format natively, so OpenOffice doesn’t have to be installed on the computer where the document is generated.
  You can find more information about the OASIS Open Document Format at http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=office.
  More information about OpenOffice can be found at http://www.openoffice.org.

• TIFF, GIF, PNG, BMP and JPEG picture format is now supported in PDF and RTF output types. (BMB and JPEG formats are supported natively, for other picture formats the GDI+ version of XFRXLIB.FLL is required)

• Turkish (1254) and Greek (1253) code pages are now supported in the PDF output

• A printer properties dialog for a given printer can now be invoked from XFRX, returning the printer properties structure as a string. This string can be saved as a user preference and sent to XFRX when printing. This functionality is similar to SYS(1037) introduced in VFP 9.0, with two differences/improvements:

  • The page setup and printer selection dialogs are skipped, which saves two clicks for the users and preempts confusions in case the printer has already been selected. (Very often, there is a printer selection box in the "main" form and a button to invoke printer properties).

  • This implementation works in earlier versions of Visual FoxPro, too (from VFP 5.0)

• A custom printer properties structure can be used when XFRX transforms the output to a printer

• HNDLIB.DLL and XFRXLIB.FLL versions check. When the required library version is not available, the warning message displays:

  • The version of currently used library file 

  • the required version

  • the location of currently used library file

• This version introduces custom scripts. Custom scripts are methods or code snippets written in Visual FoxPro, which can be linked to objects on the report or triggered during the processing of the report, and can be used to "draw" to the report being processed: to generate pictures, add any custom graphics (graphs, watermarks, etc.), text objects, hyperlinks, bookmarks and many more.
  The new version also allows to bypass the reporting engine altogether and create any of the output formats supported by XFRX from scratch – directly from your Visual FoxPro code.  
  Please see the Developer's guide at http://www.eqeus.com/xfrxmanual.php for more information.
• Text message of the error codes returned by SetParam method can now be retrieved with ErrorMessage method.

• XFRX is now able to print the generated reports. You can print the stored XFF files as well as print directly from the advanced previewer.The advanced previewer implements a simple printer selection dialog, with an option to select page ranges to print, which can be easily overwritten by a custom form. Please see the Developer's guide at http://www.eqeus.com/xfrxmanual.php for more information.