XFRX versions 14.1, Release notes

Release date: 6 December 2010

Office 2010 compatibility notes fixes

• Word 2010 - fixed the problem with pictures missing
• Intermittent Excel 2010 freezing fixed
• Issues with picture frames in flow layout word output fixed
• "Cannot load Word or Excel application" error message - be aware XFRX does not support Office 2010 running in "Click to run" setup mode.
  More info at: http://xfrx.blogspot.com/2010/12/office-2010-and-click-to-run.html

XFRX versions 14.0, Release notes

Release date: 19 July 2010

New features

Digital signatures in PDF

The digital signature can be used to validate the document content and the identity of the signer. (You can find more at http://en.wikipedia.org/wiki/Digital_signature). XFRX implements the "MDP (modification detection and prevention) signature" based on the PDF specification version 1.7, published in November 2006.

The signing algorithm in XFRX computes the encrypted document digest and places it, together with the user certificate, into the PDF document. When the PDF document is opened, the Adobe Acrobat (Reader) validates the digest to make sure the document has not been changed since it was signed. It also checks to see if the certificate is a trusted one and complains if it is not. The signature dictionary inside PDF can also contain additional information and user rights - see below.

At this moment XFRX supports invisible signatures only (Acrobat will show the signature information, but there is no visual element on the document itself linking to the digital signature). We will support visible signatures in future versions.

In the current version, XFRX is using the CMS/PKCS #7 detached messages signature algorithm in the .net framework to calculate the digest - which means the .NET framework 2.0 or newer is required. The actual process is run via an external exe - "xfrx.sign.net.exe", that is executed during the report conversion process. In future, we can alternatively use the OpenSSL library instead.

How to invoke the digital signing

(Note: the syntax is the same for VFP 9.0 and pre-VFP 9.0 calling methods)

To generate a signed PDF document, call the DigitalSignature method before calling SetParams. The DigitalSignature method has 7 parameter:

Demo

The demo application that is bundled with the package (demo.scx/demo9.scx) contains a testing self-signed certificate file (TestEqeus.pfx) and a sample that creates a signed PDF using the pfx. Please note Acrobat will confirm the file has not changed since it was signed, but it will complaing the certificate is not trusted - you would either need to add the certificate as a trusted one or you would need to use a real certificate from a certification authority (such as VeriSign).

Feedback

Your feedback is very important for us. Please let us if you find this feature useful and what features you're missing.

XFRX versions 12.9, Release notes

Release date: 15 June 2010

Bugs fixed

• PDF output - multiline text rendering - center and right-aligned text is now rendered properly
• PDF output - specific BMP picture subformats (32 bpp and others) were rendering as a black box. This problem has been fixed.
• VFP 9 listener mode - Render method now properly calls the chained report listeners' methods
• The proper field codepage is now stored in the XFRX intermediate file
• High resolution pictures now render and print properly
• "@L" picture format is now working correctly in all VFP versions
• Warning about "page" index overwrite is removed
• Warning about "pos" index overwrite is removed
• The correct background color wasn't displaying for fields marked as opaque using a dynamic condition
• "#UR OUTLINE" and "#UR TOOLTIP" now support numeric values
• XFRX previewer - an error was showing when no data were loaded
• XFRX previewer - email icon tooltip fixed
• XFRX previewer - intermittent crashing was fixed [negative window handlers]
• XFF Printing - enhanced custom paper-size handling
• XFF Printing - paper orientation problems fixed

XFRX versions 12.8, Release notes

Release date: 22 November 2009

New features / Updates

• XFRX previewer - file selection button ([...]) has been added to the export options form
• XFRX previewer - new properties for default values for zoom, pages-per-sheet, default output name and a starting page:
  A new object-type property has been added to the XFCont, cntXFRXMultipage and frmMPPreviewer classes: oDisplayDefaults. It has the following properties:
  • StartingPage (integer) - the 1st page to show in the previewer. Default value is 1.
  • DefaultOutputFileName (string) - the default output file name when exporting from the previewer
  • PagesPerSheet (string) - encoded pages per sheet layout value. Default value: 1x1. Allowed values: 1x1, 2x1, 2x2, 3x1, 3x2, 4x2.
  • ZoomFactor (integer) - the zoom factor. default value = 100. -1 = fit to width, -2 = fit page. The zoom factor will be used only of PagesPerSheet is 1x1, otherwise it defaults to -2.
  
  Example:

  loPreview = CREATEOBJECT("frmMPPreviewer")
  loPreview.oDisplayDefaults.StartingPage = 2
  loPreview.oDisplayDefaults.DefaultOutputFileName = "invoice15_09"
  loPreview.oDisplayDefaults.ZoomFactor = -1
  loPreview.oDisplayDefaults.PagesPerSheet = "1x1"
  loPreview.PreviewXFF(loXFF)
  loPreview.show(1)
  				

Bugs fixed

• Dynamic properties in VFP 9.0 - dynamic textbox background is now displayed correctly
• Rectangle-bound scripts in VFP 9.0 are now correctly evaluated
• Word output - the page margins are updated so that wide reports fit into the paper size
• PDF output - word wrapping algorithm didn't intermittently work properly with dashes and some other characters that allow for wrapping to a new line
• PDF output - fonts with no code page are now properly handled if a code page is specified
• PDF output - left and center alignment calculation shift in GDI+ mode has been fixed
• Word output - the temporary XML copy of the word document could have been left undeleted with certain Word versions
• Previewer - XFRX previewer now works properly in top-level forms
• "@Z$" format string is now handled properly
• Printing - the printer paper size is now automatically pre-selected with the report paper size
• 'X_TRIM missing' error is fixed
• Excel output in VFP 9.0/SP2 now properly exports numeric values and numeric formats - if you need the numeric values, set the CallEvaluateContents property of the xfrxlistener to 2.
  More details: the actual bug was caused by the new Listener properties introduced in SP2: CallAdjustObjectSize, CallEvaluateContents. When the default parent report listener is used (fxlistener at FFC), it checks for the report dynamics and if there are not any, it sets these two properties to 1 and thus disables the EvaluateContents calls. However, when EvaluateContents is not called, XFRX won't know about the actual numeric value and the output will be exported as a text.

XFRX versions 12.7, Release notes

Release date: 23 December 2008

New features / Updates

• Trim mode is now supported in all VFP versions
  In VFP 9.0 the trim mode is controlled by the "Trim mode for character expressions" setting on the "Format" tab in the "Field Properties" form.
  In pre-VFP 9.0 version the trimming is controlled by a special string in fields comment: #UR TRIM=, followed by the trim mode code:

  Code	Description
  0	Default trimming in pre-VFP 9.0 versions - trim to nearest word
  1	Trim to nearest character
  2	Trim to nearest word
  3	Trim to nearest character, append ellipsis
  4	Trim to nearest word, append ellipsis
  5	Show inner path as ellipsis

  Example: #UR TRIM=3 wraps to the nearest character and appends ellipsis

• Shape fill pattern is now correctly rendered in picture and print output
• XFRX Previewer - middle click now closes the active tab

Bugs fixed

• Intermittent crashing on Windows Vista with specific printers has been fixed
• The printed output was occasionally shifted for specific printers
• Open office output layout issues have been fixed
• Page-range filtering didn't work for merged reports
• XFRX previewer issues
  • Double-click on a custom hyperlink executed the linked event twice
  • Bookmark panel size wasn't setup correctly during drilldown
  • The previewer form didn't work correctly inside top-level forms
  • Occasional screen flickering during drilldown
  • Print options do not show if no printers are installed

Known issue: The full justify feature (<FJ>) does not work in the previewer. We are working on fixing this as soon as possible.

XFRX versions 12.6, Release notes

Release date: 01 August 2008

New features / Updates

• Full justification is now supported in PDF, Word output, picture export and the XFRX previewer
  Add <FJ> into the comments of the fields you want to full justify.
• Absolute layout boxes in Word output are now automatically expandable
• Picture rotation is now supported in VFP 9.0, using the new SP2 designer user interface
• XFRX Previewer
  • Hyperlink decoration can now be suppressed on the printer output
    A new property has been added to the XFCont, cntXFRXMultipage and frmMPPreviewer classes: UnderlineHyperlinksOnPrint. You can use the following values:
      0 - no decoration for hyperlinks
      1 - display "normal" hyperlinks in blue, but do not decorate custom event hyperlinks (green)
      2 - (default value) decorate both blue and green hyperlinks
    
    To support this, the PrintDocument method of the XFRX#DRAW class has a new parameter, tnUnderlineHyperlinksOnPrint, with the same values and logic.
  • Custom buttons can now be added to the XFRX previewer toolbar at runtime
    This feature is implemented using the extension handler mechanism: A new method is now supported - ToolbarOnInit, which is invoked at the time the toolbar is initialized. In this method the extension handler can add new buttons to the previewer and their click events can be bound with other methods in the extension handler. A new property is now supported, too - oPreviewContainer. If it is available, the previewer will automatically fill it with the XFCont object reference for easier access to the previewer properties in the custom buttons click event methods.

    Example:

    use demoreps\sales
    local loSession, lnRetval, loXFF, loPreview, loScripts
    loSession=EVALUATE([xfrx("XFRX#LISTENER")])
    lnRetVal = loSession.SetParams(,,,,,,"XFF") && no name = just in memory
    If lnRetVal = 0
    	REPORT FORM demoreps\sales object loSession
    	*
    	* the XFRX#DRAW object reference is stored in oxfDocument property
    	*
    	loXFF = loSession.oxfDocument
    	*
    	* initialize the previewer 
    	*
    	SET PATH TO xfrxlib
    	SET CLASSLIB TO xfrxlib ADDITIVE 
    	loPreview = CREATEOBJECT("frmMPPreviewer")
    	*
    	* setup the extension handler
    	*
    	loPreview.oExtensionHandler = CREATEOBJECT("SampleExtensionHandler")
    	loPreview.windowtype = 1 
    	loPreview.iTool = 2 && embedded toolbar
    *	loPreview.iTool = 1 && standard toolbar
    	loPreview.PreviewXFF(loXFF)
    	loPreview.show(1)
    ENDIF
    
    DEFINE CLASS SampleExtensionHandler as Custom
    
    	oPreviewContainer = null
    
    	PROCEDURE ToolbarOnInit
    	LPARAMETERS toToolbar
    	LOCAL button
    	IF toToolbar.AddObject("mybutton", "commandbutton")
    		BINDEVENT(toToolbar.mybutton, "click" , this, "ButtonClicked")		
    		toToolbar.mybutton.tabindex = 1
    		toToolbar.mybutton.Visible = .t.
    		IF UPPER(totoolbar.BaseClass)!="TOOLBAR"
    			toToolbar.mybutton.left = toToolbar.cmdQuit.left
    			toToolbar.cmdQuit.left = toToolbar.mybutton.left + toToolbar.mybutton.width
    		ENDIF		
    	endif
    
    	PROCEDURE ButtonClicked
    	LOCAL lcString
    	lcString = "this.oPreviewContainer.Name: "+this.oPreviewContainer.Name+CHR(13)
    	lcString = lcString + "current page: "+TRANSFORM(this.oPreviewContainer.nPageNo)+CHR(13)
    	lcString = lcString + "XFRX#DRAW Object: "+this.oPreviewContainer.oXFRXWriter.Name+CHR(13)
    	lcString = lcString + "Page count: "+TRANSFORM(this.oPreviewContainer.oXFRXWriter.PageCount)+CHR(13)
    	WAIT WINDOW lcString
    *	
    *	this.oPreviewContainer.oXFRXWriter.PrintDocument(...)
    *	this.oPreviewContainer.oXFRXWriter.SavePicture(...)
    ENDDEFINE
    
                            

Bugs fixed

• "SET NULL ON" problem has been fixed
• A problem with previewer crashing on Windows Vista has been fixed
• Dynamic background is now supported in VFP 9

XFRX versions 12.5 + 12.4, Release notes

Version 12.5 released on: 31 January 2008
Version 12.4 released on: 14 November 2007

New features / Updates

• VFP 9.0 SP2 features are now supported

  This version supports both VFP 9.0 SP2 and VFP 9.0 pre-SP2 environments. In SP2 it supports the new dynamics and rotation features.

• GDI+ compatible word wrapping algorithm
  
  The new version comes with an alternate GDI+ wordwrapping algorithm. Since the introduction of VFP 9.0 we are experiencing layout compatibility issues between the old reporting engine (pre-VFP 9.0) and the new reporting engine (VFP 9.0). [Please see Guide to Reporting Improvements VFP 9.0 help topic for more information.]

  With XFRX we are experiencing a similar problem - while the pre-VFP 9.0 report engine inside XFRX is using GDI for wordwrapping and layout calculation, the VFP 9.0 report that is used in XFRX for VFP 9.0 is using GDI+. Moreover, XFRX is using GDI+ for printing, output to pictures and previewing. The main difference between using GDI and GDI+ is text width. Each text element is slightly wider with GDI+, which can result in element content being cut, earlier wrapping longer stretched fields. Here is a summary:

  XFRX ver. 12.3 and earlier
  	   VFP 9.0  Â	VFP 8.0 and earlier
  Output to PDF and other output formats	GDI	GDI
  Report engine	GDI+	GDI
  Report previewer	GDI+	GDI+
  Printing out of XFRX	GDI+	GDI+

  Although converting everything to GDI+ would ease the complexity, it would bring another problem - "old" reports might need to be modified. So, instead, the latest XFRX version now contains both GDI and GDI+ wordwrapping algorithms and you can choose which one is going to be used. By default GDI+ is used in VFP 9.0 in the listener mode and GDI is used in VFP 8.0 earlier. There is probably no reason to switch to GDI in VFP 9.0 but it might sometimes be useful to switch to GDI+ as printing and previewing is still in GDI+:

  XFRX ver. 12.4 with wordwrapping set to GDI+
  	   VFP 9.0  Â	VFP 8.0 and earlier
  Output to PDF and other output formats	GDI+	GDI+
  Report engine	GDI+	GDI+
  Report previewer	GDI+	GDI+
  Printing out of XFRX	GDI+	GDI+

  XFRX ver. 12.4 with wordwrapping set to GDI
  	   VFP 9.0  Â	VFP 8.0 and earlier
  Output to PDF and other output formats	GDI	GDI
  Report engine	GDI+	GDI
  Report previewer	GDI+	GDI+
  Printing out of XFRX	GDI+	GDI+

  To set the wordwrapping algorithm manually then, before running your reports, create a public or private variable _xfrx_WordWrapAlgorithm and set it to 1 for GDI mode and 2 for GDI+ mode.

• E-mail support in the XFRX previewer

  An email icon has been added to the XFRX previewer toolbar. It is disabled by default for backward compatibility and can be enabled by setting the iEmail property of the previewer class [xfCont, cntXFRXMultiPage or frmMPPreviewer] to 1. If you click the email icon, it runs the Email method of the xfCont class. By default it displays a simple dialog box asking for email address, subject, body, etc. and uses VFPWinsock library to send the email.

  Note: VFPWinsock is a free SMTP sendmail library written by a VFP MVP Francis Faure. It is not distributed together with XFRX and it can be downloaded from http://www.xfrx.net/vfpWinsock/index_e.asp. It is a nice little package written in VFP distributed as a single .prg.
  The default behavior can be intercepted or overridden by an extension handler [Please find more information about extension handlers in the Developer's Guide here:] - and, as the default dialog does not ask for all information VFPWinsock needs (eg. it does not ask for SMTP host) you actually need to create an extension handler to make it work in your environment. There are two events that extension handler can implement:
  • Email - the event is fired when the icon is clicked, before the dialog is displayed. XFF file reference is sent as the 1st parameter. Returning .F. will suppress the default behavior.
  • EmailOptions - this event is fired after the dialog is displayed and user clicked "Send". XFF file reference and options object is sent as a parameter. Returning .F. will suppress the email to be sent

    The parameter object has the following properties:

    • cTo
    • cCC
    • cBCC
    • cSubject
    • cAttachmentName
    • cBody

  Following are sample of the two most common scenarios:

  • Suppress the default behavior and handle the email event on your own

    loPreview = CREATEOBJECT("frmMPPreviewer")
    loPreview.iEmail = 1 && show the email icon
    loPreview.oExtensionHandler = CREATEOBJECT("SampleExtensionHandler")
    loPreview.PreviewXFF(loXFF) && preview the document 
    loPreview.show(1)
    
    DEFINE CLASS SampleExtensionHandler as Custom
    
    PROCEDURE Email
    LPARAMETERS  loXFF
    LOCAL loSession, lcFileName
    loSession=EVALUATE([xfrx("XFRX#INIT")])
    lcFileName = Addbs(Sys(2023))+"test.pdf" && temporary file name
    If loSession.SetParams(lcFileName,,.T.,,,,"PDF") = 0 && the 3rd parameter says we do not want to preview the PDF
    	loSession.TransformReport(loXFF)
    	
    	LOCAL sm
    	Set Procedure To vfpwinsock ADDITIVE 
    	sm = Createobject("vfp_winsock_send_mail")
    	sm.smtp_host = "your.smtp.server.here" &&&<<<<<<<<<<<<<<<<<<<< put your smtp server here
    	sm.From = "eqeus@eqeus.com" 
    	sm.To = "eqeus@eqeus.com"
    	sm.subject = "Email test"
    	sm.silence = .T.
    	sm.attaCHMENT = lcFileName
    	if !sm.Send()
    		MESSAGEBOX(sm.erreur,16,"xfrx test")
    	ELSE
    		MESSAGEBOX("Message was sent",0,"xfrx test")
    		ERASE (lcFileName)
    	endif
    
    Endif
    
    RETURN .F.
    ENDPROC
    
    ENDDEFINE
    

  • Use the default dialog box, use an extension handler to supply mail server parameters and let XFRX send the email

    DEFINE CLASS SampleExtensionHandler as Custom
    
    PROCEDURE EmailOptions
    LPARAMETERS  loXFF, loOptions
    loOptions.cSMTP_HOST = "mail.your_domain.com"
    loOptions.cFrom = "eqeus@eqeus.com"
    ENDPROC
    
    ENDDEFINE
    

Bugs fixed

• Landscape printing has been improved, both clockwise and anti-clickwise rotation is now supported
• Landscape reports printing as portrait in Word has been fixed
• The 10000 lines limit in XLS output has been removed
• Picture shift problem in XLS has been fixed

XFRX version 12.3, Release notes

Release date: 27 August 2007

New features / Updates

• New output type - XPS
  
  The XPS [XML Paper Specification] is a new document specification developed by Microsoft. You can find more information about XPS at:
  • http://www.microsoft.com/whdc/xps/default.mspx
  • http://en.wikipedia.org/wiki/XML_Paper_Specification
  There are no special requirements regarding the platform setup – especially .NET framework is not required. XFRX generates the document on its own from scratch so all you need is VFP and XFRX.

  To be able to preview the XPS document, you need an XPS document viewer. If you are running Windows Vista you already have one as it is included with .NET Framework 3.0. For Windows XP and Windows Server 2003 you can download the viewer from http://www.microsoft.com/whdc/xps/viewxps.mspx.

Bugs fixed

• Speedup - the XFF file processing and PDF generation should be around 10-20% faster
• "Money" type was not properly handled in some scenarios
• Printing multiple pages per sheet was not working correctly for the "letter" size papers
• Horizontal and vertical lines were not properly rendered in page footer for flow layout output types (FDOC, FRTF)
• A bug causing slowdown when exporting to PDF was fixed
• PAGETOTAL variable was not correctly evaluated when merging multiple reports
• A combination of a specific font, "stretch" flag and a textbox height could cause an occasional blank line inclusion
• Appending to PDF - PDF files with a specific format were not correctly supported
• Printing - layout problems with landscape reports have been fixed
• VFP 8 engine - objects on bands wrapped to a new page occasionally got a wrong z-index
• VFP 9 engine
  • Cancelling a report was producing an empty document. No whatever was processed till the user cancelled the report is generated in the document.
  • Exporting landscape reports to Word produced a document that appeared as portrait when printed
  • AdjustObjectSize event is now properly propagated to listener's successors
• XFRX previewer
  • Navigation using searched keywords was not working correctly when SET EXACT was set to ON
  • Various tweaks were done to improve the user interface

XFRX version 12.2, Release notes

Release date: 5 December 2006

New features / Updates

• XFRX Advanced Previewer
  • Printer selection dialog enhanced
    The dialog contains new controls allowing for the following options:
    • The number of copies to print
    • Include odd / even or all pages
    • Zoom - printing multiple pages per sheet
  • Export dialog enhanced
    The dialog allows for the following new features:
    • Specify the export output targets that would be available for selection
    • When exporting to "Image" output formats, the following new options are available:
      • The number of copies to print
      • Include odd / even or all pages
      • Zoom - printing multiple pages per sheet
      • The DPI of the image created
  • Previewer extension handler
    The extension handler now supports two new events (PrintOptions and ExportOptions) - print and export events after the options dialog is selected and the user clicks [Ok]. The events receive two parameters - the XFF object reference and an object containing the parameters user selected.
    
    
    Example: Defining the export output options list, intercepting the XLS export
    

     
    
    				

    USE invoices ORDER customer
    LOCAL loSession, lnRetval, loXFF, loPreview, loScripts
    loSession=EVALUATE([xfrx("XFRX#LISTENER")])
    lnRetVal = loSession.SetParams("",,,,,,"XFF") && no name = just in memory
    If lnRetVal = 0
    	REPORT FORM invoices OBJECT loSession		
    	loXFF = loSession.oxfDocument
    	*
    	* initialize the previewer 
    	*
    	SET CLASSLIB TO xfrxlib ADDITIVE 
    	loPreview = CREATEOBJECT("frmMPPreviewer")
    	loPreview.setExtensionHandler(CREATEOBJECT("MyExtensionHandler"))
    	loPreview.windowType = 0
    	loPreview.iBook = 0
    	loPreview.PreviewXFF(loXFF)
    	loPreview.show(1)
    ENDIF
    
    
    DEFINE CLASS MyExtensionHandler AS Custom
    
      PROCEDURE Export
        LPARAMETERS toXFF
    	IF USED("_xfExportTypes")
    		USE IN _xfExportTypes
    	ENDIF
    	*
    	* define my export options list
    	*
    	CREATE CURSOR _xfExportTypes (name C(50), extension C(4), targetCode C(10))
    	INSERT INTO _xfExportTypes VALUES ("HTML",	"html",	"HTML")
    	INSERT INTO _xfExportTypes VALUES ("PDF",	"pdf",	"PDF")
    	INSERT INTO _xfExportTypes VALUES ("Excel",	"xls",	"XLS")
      ENDPROC
     
      PROCEDURE ExportOptions
        LPARAMETERS toXFF, toOptions
    	IF toOptions.cTarget = "XLS"
    		*
    		* my own code to handle output to Excel
    		*
    		=MESSAGEBOX("exporting to "+toOptions.cOutputFile)
    		RETURN .F.   && suppress the default behavior
    	eLSE
    		RETURN .T.   && continue with the default behavior
    	ENDIF
    
      ENDPROC
    ENDDEFINE
    

  
  
• Printing and exporting to pictures
  The SavePicture and PrintDocument methods now have new parameters for controlling whether to include all pages, odd or even only, the number of copies and the number of pages per sheet.

Bugs fixed

• frmMPPreviewer class was missing the iBook property
• Private data session reports were causing crashes in previewer (VFP 9)
• Opaque colored backgrounds were not printing properly
• The report previewer wasn't sending the XFF file reference parameter to the extension hander events
• Displaying multiple pages at once in the previewer was not working correctly (old pages being left on the screen) if there were not enough pages remaining in the document
• XFRX was producing corrupted PDFs when fonts were included in the document (error 135)
• Appending to PDF was improved (more PDF document "subformats" are now supported)
• Wrapped lines were dropped in the previewer (in some scenarios)
• OpenOffice - the absolute layout output was not working correctly (blank textboxes) with the latest OpenOffice version
• The word wrapping algorithm was not respecting the current code page - Cyrillic texts having lines too wide
• VFP 8 engine - vertical lines are now properly wrapped to a new page when stretched bands wrap
• If the page range is not specified for SavePicture and PrintDocument method, the whole document is exported/printed

XFRX version 12.1, Release notes

Release date: 5 September 2006

New features / Updates

• XFRX Advanced Previewer
  
  
  • The previewer is now able to preview multiple pages at once
    A new selection control on the toolbar can now switch the previewer to display up to 8 pages at the same time
    
  • Displaying progress bar  
    A progress bar object reference can be sent to the previewer to show progress when exporting to PDF and other output formats 
    
    
    Example:
    
    loXFF = XFRX("XFRX#DRAW")
    loXFF.openDocument("output.xff")
    loProgress = createobject("progress") && this is a progress object that will be passed to the previewer
    loPreview = CREATEOBJECT("frmMPPreviewer")
    loPreview.oProgress = loProgress && set the reference
    loPreview.previewXFF(loXFF, "XFRX sample",1,"XFRX Sample Job name") && you can now also specify the printer job name
    loPreview.show(1)
    
    define class progress as custom
      procedure updateProgress
        lpara tnReport,tnPage,tnPercentage
        wait window nowait "Exporting page: "+allt(str(tnPage))+" (Press Ctrl+Q to Cancel)"
      endproc
    enddef
    
    
  • Exporting from the previewer can be cancelled by user action
    The TransformReport method now reacts to the gnStopXFRX public variable change so that the export in progress can be cancelled
    
    
    Example:
    
    PUBLIC gnStopXFRX
    ON KEY LABEL CTRL+Q gnStopXFRX = 1 && the subsequent report exporting can be cancelled by 
                                       && pressing CTRL+Q
    
    
    
  • Print job name can be specified for each previewing document
    A new (4th, optional) parameter of the PreviewXFF method specifies the printer job name. If the 4th parameter is empty, the 2nd parameter (report caption) is used as the printer job name. If both 2nd and 4th parameters are empty, the default printer job name "XFRX" is used.

Bugs fixed

• Bookmarks were not exporting to PDF
• OpenOffice output didn't work correctly with SET EXACT flag set to ON
• Memory leak problem in XFRXLIB.FLL was fixed
• RightClick and MouseWheel events are now properly handled in the XFRX previewer
• Flow layout options - bands wrapping on a new page were incorrectly rendered as page headers
  
  

XFRX version 12.0, Release notes

Release date: 17 August 2006

Installation notes:

• The XFRX previewer component requires FOXTOOLS.FLL library if used in VFP 6.0.
• XFRXLIB.FLL now also requires MSVCP71.DLL library to be installed (the previous version required GDIPLUS.DLL and MSVCR71.DLL libraries)

New features / Updates

• New output types
  
  
  • Flow layout Open Office Writer document (FODT)
  • Absolute layout Open Office Calc Spreadsheet (ODS)
  • Flow layout Open Office Calc Spreadsheet (FODS)
  
  

  Since 12.0, the Writer and Calc outputs are supported, both of which can be generated either using the absolute or flow layout format (please see chapter "Flow layout document option" in the Developer's guide for more information about the flow layout options).
  
  

  To generate the OpenOffice document, use the following codes as the 7^th parameter (targetType) of the SetParams method:

  Document type	targetType
  OpenOffice Writer document with absolute layout	ODT
  OpenOffice Writer document with flow layout	FODT
  OpenOffice Calc spreadsheet with absolute layout	ODS
  OpenOffice Calc spreadsheet with flow layout	FODS

  
  

• XFRX Advanced Previewer
  
  The displaying component was completely reworked, result of which is:
  
  
  • Significant speed increase
    The previewer is now about 50 times faster in displaying the page content and moving from one page to another
  • Unicode support
    The previewer now supports Chinese and Japanese code pages, correctly displays Hebrew and Arabic and supports multiple code pages within single report (new feature in VFP 9)
  • Better rendering
    As the XFRX previewer in previous version was using GDI, text with small font sizes was displayed slightly wider, which was causing various layout discrepancies. These problems are now gone as the new previewer is using GDI+.
  • Rotated text
    Rotated labels and fields are now supported in the previewer
  • Searching
    Searching in the previewer is now significantly faster. The whole document is searched, all found occurences are listed in a side panel (as hyperlinks/bookmarks).
  
  
• PDF Output
  
  Unicode is now supported in the PDF output type. This allows for converting of multi-byte code pages (Chinese, Japanese) as well as supporting multiple code pages withing one report / document. 
  The unicode samples can be downloaded from: http://www.eqeus.com/files/xfrx12_demos.zip
• Printing and export to pictures
  
  
  • These output types now also support unicode and multiple character sets.
  • When exporting to pictures, the 7th and 8th parameters can specify a DPI or a zoom factor of the picture 

    Example:

    loXFF.SavePicture("output.bmp","BMP",1,1,24,,"DPI",300) && saves the picture as 300 DPI
    loXFF.SavePicture("output.bmp","BMP",1,1,24,,"ZOOM",150) && zoom to 150%
    						

Bugs fixed

• Occasionally, pictures stored in relative paths to the FRX file locations were not correctly displayed.
• Font subset embedding didn't work correctly with true type fonts with short "loca" table adressing.
• Occasional crashing when converting reports to pictures.
• If the datasession Init method returned .F., the report was not properly cancelled.
• Pictures with zero height or width were causing a corrupted PDF
• When PictureDPI property was set, "stretch picture, retain shape" wasn't working correctly in PDF
• The layout of printing / previewing / generating pictures was improved - "cleaner" lines, proper handling of transparent / invisible rectangles

XFRX version 11.3, Release notes

Release date: 14 March 2006

New features / Updates

• XFRX Advanced Previewer
  
  
  • Tabbed interface
    The advanced previewer can now preview multiple documents using the popular tabbed interface approach.
    
  • Custom event hyperlinks (drill-down)
    

    XFRX now recognizes two types of hyperlinks:

    • “normal” hyperlinks (printed in blue), which navigate to other places in the report or to an external web address and
    • “custom event” hyperlinks (printed in green), where XFRX allows for assigning a custom VFP code that will be called when users click the hyperlink.

    This “custom event” hyperlink feature can be used to invoke application specific actions (information forms, custom processes, etc.) or for implementing drill-down functionality – invoking detailed report where the field user clicked on is taken as a parameter for the report (for example, clicking a customer name in the report listing all customers can run a report with detail information about this specific customer). The new report can be directed to a new page of a multipage previewer, which could provide a comfortable environment for “drilling down” specific information – with the ability to go back to the original report without closing the current one, side by side report comparison, exporting / printing selected reports, etc.
    
    Please find more information about this feature as well as a step-by-step example in the Developer's guide, "Implementing custom event hyperlinks (drilldown) in XFRX previewer" chapter.

  • Fake toolbar option
    The previewer can now optionally replace the default toolbar with a toolbar-like control placed above the previewer control. This option can be very useful if the previewer form is not inside the main VFP screen.
    
  • New toolbar icon - "Export"
    If the user clicks at the new Export icon, a dialog with the output type and the file name selection is displayed and the output document is generated based on options selected.
    
  • Previewer extension handler
    The extension handler allows for extending the functionality of the basic classes without need of creating subclasses. All you need is to create a custom class, which implements certain methods. The custom class is registered with the XFRX previewer class (using SetExtensionHandler method) and the previewer calls the extension methods on appropriate events.
    
  • The previewer instantiation is now significantly simplified
    A complete standalone-window previewer is now shipped with XFRX - all you need to do to make it work is to instantiate a class and call one of its methods with an XFF file to preview as a parameter. Alternatively, you can use the prepared single document or multiple documents (tabbed interface) controls to your forms.
    
    Please find more information about the advanced previewer in the Developer's guide, "XFRX previewer" chapter.
    
  • German localization is now available
    
• PDF output format
  • Hebrew code page (cp 1254) is now supported
  • Pictures are binary comparised to reduce the size of PDF documents with repeated pictures
  • VFP 9: DynamicLineHeight property is used to control if the text field background color should fill the whole textbox (VFP 9 default behavior) or only the actual text printed (VFP 8 backward compatibility behavior)
    
• General
  • Target image DPI can be specified (large pictures can be downsampled to reduce the result document size)  [see PictureDPI property for XFRXListener and XFRXSession classes at Developer's guide, "Properties and methods common in XFRXListener and XFRXSession classes" chapter].
  • Image quality can be specified for ActiveX objects [see DefaultPictureFormat property for XFRXListener and XFRXSession classes at Developer's guide, "Properties and methods common in XFRXListener and XFRXSession classes" chapter].
    

Bugs fixed

• Strikethrough font attribute is now correctly recognized
• Exporting to image formats was crashing in VFP7.
• XFRX Previewer
  • SetLanguage method was modifying the actual SELECT area

Evaluation package note: The Prevdemo directory with the XFRX previewer implementation sample has been removed as the same functionality is now supported by the "native" class frmMPPreviewer of XFRXLib.vcx.

XFRX version 11.2, Release notes

Release date: 6 December 2005

New features