PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Required configuration
  • How to directly start the PDF generated during a print?
  • Printing reports in PDF format in Linux
  • Limitations: reports controls supported in Linux
  • Printing in WLanguage in Linux
  • Step 1: Configuring the print parameters
  • Step 2: Creating print fonts
  • Step 3: Printing characters, images
  • Step 4: Start printing
  • List of print functions available in Linux
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview
WEBDEV and WINDEV allows you to print in PDF format in Linux with the WLanguage functions. You have the ability to perform:
  • WLanguage prints in PDF format.
  • Versions 15 and later
    prints of reports created with the report editor in PDF format.
    New in version 15
    prints of reports created with the report editor in PDF format.
    prints of reports created with the report editor in PDF format.
The print is performed via the WLanguage functions like any other standard print.
This help page presents the limits for printing in Linux.

Required configuration

To use the print features in WEBDEV Linux, you must install:
  • the QT library (Core and GUI), version 4.5 or later.
    In Ubuntu, the QT library can be installed with the following commands:
    sudo apt-get install libqtcore4
    sudo apt-get install libqtgui4
  • the LibFreeType.so library (32 or 64 bits), version 6 or later.
    Caution: The PC SOFT framework searches for the libfreetype.so library. If only the libfreetype.so.6 file exists, you must create a symbolic link via the following command:
    ln -s /usr/lib/libfreetype.so.6 /usr/lib/libfreetype.so
Caution: In version 14, printing in Linux was using the Magick library. This library is not required anymore.
Note: You have the ability to install Microsoft fonts in Linux in order to get reports closer to their preview in Windows. In Ubuntu, these fonts can be added by following this procedure: http://doc.ubuntu-fr.org/msttcorefonts.
Note: The following Linux distributions are supported:
  • Debian 5.02
  • Ubuntu 10.04

How to directly start the PDF generated during a print?

To directly start the PDF created during the print, all you have to do is use the following commands:
xdg-open url
or
gnome-open url
Printing reports in PDF format in Linux
The different steps for printing reports in Linux are as follows:
  • Step 1: Configuring the destination of the print.
    This configuration is performed by iDestination. Only the print in PDF format is available in Linux, therefore iDestination must be used with the constants for generating PDF files (iPDF or iGenericPDF).
  • Step 2: Starting the print.
    The report is printed by iPrintReport.

Limitations: reports controls supported in Linux

The following controls are supported in a report printed in Linux:
  • Static control (the RTF mode is not supported).Static control (the RTF type is not supported).
  • Calculated control.
  • Image control.
  • Preset control.
  • Shape control.
  • Internal Report control.
  • Link control.
  • Edit control.
  • Bar Code control.
  • Chart control.
  • Check Box control.
  • Organizer control.
  • Scheduler control.
  • Versions 21 and later
    Spreadsheet control.
    New in version 21
    Spreadsheet control.
    Spreadsheet control.
  • Item control (the RTF mode is not supported).
The following controls are not supported:
  • RTF control.RTF Static control.
  • Pivot Table control.
  • Gantt Chart control.
  • Versions 21 and later
    Signature control.
    New in version 21
    Signature control.
    Signature control.
  • HTML control.HTML Static control.
Printing in WLanguage in Linux
The steps for printing in WLanguage as are follows:

Step 1: Configuring the print parameters

This step is used to choose the print parameters for the document (quality, orientation).
This step is optional.
The different operations are as follows:
  1. Selecting the parameters for printing the document (iParameter). When printing in Linux, you have the ability to only configure the format of the page or its orientation.
  2. Re-defining the print margins (iMargin). The top, bottom, left and right margins can be modified. If this function is not called, the default margins (differ according to the selected printer) will be used.
Caution: The order of above-mentioned operations must be respected. If a print is in progress, iParameter cancels the current print.

Step 2: Creating print fonts

This step allows you to define and choose the different fonts that will be used in the printed document.
You can only choose fonts specific to the print: these fonts will be available when printing with the WLanguage functions.
This step is optional.
The default font is used if no font is specified for the print.
  • Font: Don't care
  • Font #0,
  • size: 12 pica,
  • normal style.
  • color: black
The print fonts are created by iCreateFont.
Notes:
  • Only the TrueType fonts (*.ttf) can be used in Linux.
  • If fonts other than basic fonts must be used, they must be installed on the WEBDEV server (by using the directories of the distribution used). See the documentation about the distribution used for more details.

Step 3: Printing characters, images

This step consists in "sending the different elements to print to the printer":
  • text,
  • images,
  • drawings, ...
The print in PDF (configured by iDestination) will be effective at the end of print (iEndPrinting).
Several WLanguage functions are used to print text, images, ... See the list of print functions that can be used in Linux for more details.
Note: Printing images: The images in JPEG, BMP, PNG and GIF format can be printed in Linux.

Step 4: Start printing

This step consists in starting the print (iEndPrinting).
List of print functions available in Linux
The following print functions are available in Linux:
Versions 09 and later
iBorder
New in version 09
iBorder
iBorder
Prints a border at specified coordinates.
Versions 16 and later
iChangeSubReportSource
New in version 16
iChangeSubReportSource
iChangeSubReportSource
Modifies by programming the report associated with a sub-report in a composite report.
Versions 09 and later
iCloseReport
New in version 09
iCloseReport
iCloseReport
Stops printing the current report immediately.
Versions 15 and later
iColumnEnd
New in version 15
iColumnEnd
iColumnEnd
Forces a column break in a multi-column report.
Versions 15 and later
iColumnNum
New in version 15
iColumnNum
iColumnNum
Returns the number of the current column in a multi-column report.
Versions 09 and later
iConfigureReport
New in version 09
iConfigureReport
iConfigureReport
Configures the printer by opening the configuration window (WINDEV and WINDEV Mobile).
Versions 09 and later
iCreateFont
New in version 09
iCreateFont
iCreateFont
Creates a new print font.
Versions 21 and later
iCurrentFile
New in version 21
iCurrentFile
iCurrentFile
Returns the name of the file currently generated.
Versions 09 and later
iDestination
New in version 09
iDestination
iDestination
Configures the print destination.
Versions 09 and later
iDidotFont
New in version 09
iDidotFont
iDidotFont
Selects the unit that will be used for the height of the fonts (created by iCreateFont): DIDOT point or PICA point.
Versions 09 and later
iDocumentCanceled
New in version 09
iDocumentCanceled
iDocumentCanceled
Used to find out whether the current print was canceled by the user.
Versions 09 and later
iDocumentPrinted
New in version 09
iDocumentPrinted
iDocumentPrinted
Allows you to find out whether the user has requested to print the document from the print preview.
Versions 09 and later
iEllipse
New in version 09
iEllipse
iEllipse
Prints an ellipse (in a rectangle).
Versions 09 and later
iEndPrinting
New in version 09
iEndPrinting
iEndPrinting
Signals the end of the document to print and actually starts printing the data stored in the printer spooler via the following functions: iPrint, iPrintImage, iNewLine, etc.
Versions 09 and later
iEndReport
New in version 09
iEndReport
iEndReport
Forces the report print to stop.
Versions 09 and later
iEscape
New in version 09
iEscape
iEscape
Sends an ESCAPE command or a data command to a printer.
Versions 09 and later
iFont
New in version 09
iFont
iFont
Selects the default font.
Versions 09 and later
iForceComplement
New in version 09
iForceComplement
iForceComplement
Forces the printing of a Body Complement block.
Versions 18 and later
iGroupAdd
New in version 18
iGroupAdd
iGroupAdd
Adds a report to a group of reports.
Versions 18 and later
iGroupConfigure
New in version 18
iGroupConfigure
iGroupConfigure
Modifies the parameters of a report found in a group of reports.
Versions 18 and later
iGroupPrint
New in version 18
iGroupPrint
iGroupPrint
Starts printing a report found in a group of reports.
Versions 09 and later
iHLine
New in version 09
iHLine
iHLine
Prints an horizontal line at specified coordinates.
Versions 09 and later
iImageHeight
New in version 09
iImageHeight
iImageHeight
Calculates the height of the image to print (in millimeters).
Versions 09 and later
iImageWidth
New in version 09
iImageWidth
iImageWidth
Calculates the width of the image to print (in millimeters).
Versions 09 and later
iInfoPrinter
New in version 09
iInfoPrinter
iInfoPrinter
Retrieves the characteristics of the current or default printer.
Versions 09 and later
iInitReportQuery
New in version 09
iInitReportQuery
iInitReportQuery
Initializes the query linked to the report (for a query with parameters).
Versions 09 and later
iInitReportQueryConnection
iInitReportQueryConnection
Initializes the query linked to the report.
Versions 16 and later
iInitSubReport
New in version 16
iInitSubReport
iInitSubReport
Initializes the parameters of a sub-report of a composite report.
Versions 09 and later
iLastFile
New in version 09
iLastFile
iLastFile
Returns
  • the full name of the last file generated during the print (PDF, RTF, text, ...).
  • the list of created duplicate files
Versions 09 and later
iLine
New in version 09
iLine
iLine
Prints a line at specified coordinates.
Versions 09 and later
iListNestedReports
New in version 09
iListNestedReports
iListNestedReports
Returns:
  • the list of nested reports currently printed (reports run by iPrintReport in one of the processes of the report currently printed).
  • the list of sequenced reports currently printed (iSequenceAdd).
Versions 09 and later
iMargin
New in version 09
iMargin
iMargin
Defines the "logical" print margins.
Versions 09 and later
iMMToPica
New in version 09
iMMToPica
iMMToPica
Converts the coordinates of a point (expressed in millimeters) into system coordinates.
Versions 09 and later
iNestedHeaderFooter
New in version 09
iNestedHeaderFooter
iNestedHeaderFooter
Prints (or not) the page headers and footers of nested report.
Versions 09 and later
iNewLine
New in version 09
iNewLine
iNewLine
Prints a line (in Windows standard, with a rounded end) at specified coordinates.
Versions 09 and later
iPageEnd
New in version 09
iPageEnd
iPageEnd
Forces the move to the next page during the report print.
Versions 09 and later
iPageHeight
New in version 09
iPageHeight
iPageHeight
Calculates the height of printable page (in millimeters) while taking the top or bottom margins into account.
Versions 09 and later
iPageHeightLeft
New in version 09
iPageHeightLeft
iPageHeightLeft
Calculates the available height (in millimeters) left on the current page while taking into account the defined margins (top or bottom).
Versions 09 and later
iPageNum
New in version 09
iPageNum
iPageNum
Returns or initializes the number of the page currently printed.
Versions 09 and later
iPageWidth
New in version 09
iPageWidth
iPageWidth
Calculates the width (in millimeters) of the printable page while taking the left or right margins into account.
Versions 09 and later
iParameter
New in version 09
iParameter
iParameter
Retrieves the configuration of the printer and configures the print.
Versions 09 and later
iParameterPDF
New in version 09
iParameterPDF
iParameterPDF
Defines the options for the generated PDF file.
Versions 09 and later
iParameterReport
New in version 09
iParameterReport
iParameterReport
Configures the printer by opening the configuration window.
Versions 09 and later
iPicaToMM
New in version 09
iPicaToMM
iPicaToMM
Converts the coordinates of a point (expressed in system coordinates) into millimeters.
Versions 09 and later
iPrint
New in version 09
iPrint
iPrint
Sends the character string passed in parameter to the print buffer.
Versions 09 and later
iPrintBarCode
New in version 09
iPrintBarCode
iPrintBarCode
Prints a bar code (inside a rectangle).
Versions 09 and later
iPrintBlock
New in version 09
iPrintBlock
iPrintBlock
Forces a report block to print.
Versions 09 and later
iPrintBodyComplement
New in version 09
iPrintBodyComplement
iPrintBodyComplement
Forces a body complement block to print while specifying the height of complement block.
Versions 09 and later
iPrintImage
New in version 09
iPrintImage
iPrintImage
Sends the image file to print to the print buffer.
Versions 19 and later
iPrintingNation
New in version 19
iPrintingNation
iPrintingNation
Modifies the current language for the next print (programmed print or report print).
Versions 09 and later
iPrintReport
New in version 09
iPrintReport
iPrintReport
Prints a report created with the report editor.
Versions 09 and later
iPrintWord
New in version 09
iPrintWord
iPrintWord
Sends the character string passed in parameter to the print "buffer".
Versions 09 and later
iPrintZone
New in version 09
iPrintZone
iPrintZone
Prints a text in a rectangular area.
Versions 09 and later
iReportPrintingStatus
New in version 09
iReportPrintingStatus
iReportPrintingStatus
Returns the status of the current print.
Versions 09 and later
iReset
New in version 09
iReset
iReset
Re-initializes the print settings (margins, font, paper format, orientation, ...) stored in the print library.
Versions 20 and later
iResetNbPages
New in version 20
iResetNbPages
iResetNbPages
Reinitializes the current number of pages, used in the preset controls such as "Number of pages" and "Page number and number of pages".
Versions 09 and later
iRoundBorder
New in version 09
iRoundBorder
iRoundBorder
Prints a border with rounded outlines at specified coordinates.
Versions 09 and later
iSelectFont
New in version 09
iSelectFont
iSelectFont
Creates a new print font from the standard window for font selection...
Versions 17 and later
iSequencingAdd
New in version 17
iSequencingAdd
iSequencingAdd
Adds a report into a sequence of report prints.
Versions 17 and later
iSequencingPrint
New in version 17
iSequencingPrint
iSequencingPrint
Prints a sequence of reports.
Versions 09 and later
iSkipLine
New in version 09
iSkipLine
iSkipLine
Forces one or more line break.
Versions 09 and later
iSkipPage
New in version 09
iSkipPage
iSkipPage
Generates a page break: the corresponding code is sent to the printer queue.
Versions 09 and later
iSubstBlock
New in version 09
iSubstBlock
iSubstBlock
Substitutes a report block for another block while the report is printed.
Versions 09 and later
iTextHeight
New in version 09
iTextHeight
iTextHeight
Calculates the height of the font for the text to print (en millimeters).
Versions 09 and later
iTextWidth
New in version 09
iTextWidth
iTextWidth
Calculates the width (in millimeters) of the text to print, according to the specified font.
Versions 09 and later
iVLine
New in version 09
iVLine
iVLine
Prints a vertical line at specified coordinates.
Versions 09 and later
iWindowCancel
New in version 09
iWindowCancel
iWindowCancel
Configures the display of the window used to cancel the current print...
Versions 09 and later
iXPos
New in version 09
iXPos
iXPos
Used to manage the horizontal position (X coordinate) of print cursor in the page.
Versions 09 and later
iYPos
New in version 09
iYPos
iYPos
Used to manage the vertical position (Y coordinate) of print cursor in the page.
Versions 09 and later
iZoneHeight
New in version 09
iZoneHeight
iZoneHeight
Calculates the necessary height of a fixed-width area in order for the entire text using the current font to be printed in this area.
Note: The iPrintxxx functions only operate with the new Linux distributions.
Minimum required version
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment