PC SOFT

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Configuring the print preview
  • Reports not created in the report editor
  • Warning message (syntax 1)
  • Configuring the different print modes
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
Warning
From version 25, the print preview has been renamed to "Report viewer". It is now recommended to use iParameterViewer.
Configures the print preview:
Remarks:
  • When printing a programmed report, all the print buttons are available in the print preview.
  • By default, all the buttons for printing a report created with the report editor are available. iParameterPreview can only be used to configure the buttons defined as visible in the report editor.
  • Two additional buttons may appear in the print preview if the application allows "Reports & Queries" (supplied with WINDEV) to be run.
    These buttons are respectively used to modify the current report and to create a new report with "Reports & Queries". These buttons are displayed only:
    • If the project allows "Reports and Queries" to be run ("Advanced" tab of the project description).
    • If the report can be modified by "Reports & Queries" ("Details" tab of the report description).
Example
// No button in the print preview
iParameterPreview(iButtonNone)
iPreview()
iPrintReport(RPT_MyReport)
// Display the printer buttons only
iParameterPreview(iButtonPrinter)
iPreview()
iPrintReport(RPT_MyReport)
// Display the Printer, PDF and WORD buttons in the print preview
iParameterPreview(iButtonPrinter + iButtonPdf + iButtonWord)
iPreview()
iPrintReport(RPT_MyReport)
// Delete the Email buttons from the print preview
iParameterPreview(iButtonAll - iButtonEmail - iButtonEmailPdf)
iPreview()
iPrintReport(RPT_MyReport)
// Display the warning message every 2000 pages
iParameterPreview(iButtonAll, 2000)
// Print a report from the print preview
iPrintReport(RPT_MyReport)
Versions 23 and later
// Display the miniature pane in the print preview
iParameterPreview(iPaneMiniatures, True)
// Print a report from the print preview
iPrintReport(RPT_MyReport)
New in version 23
// Display the miniature pane in the print preview
iParameterPreview(iPaneMiniatures, True)
// Print a report from the print preview
iPrintReport(RPT_MyReport)
// Display the miniature pane in the print preview
iParameterPreview(iPaneMiniatures, True)
// Print a report from the print preview
iPrintReport(RPT_MyReport)
Syntax

Displaying (or not) the different options in the toolbar of print preview Hide the details

iParameterPreview(<Options> [, <Warning>])
<Options>: Integer constant (or combination of constants)
Buttons that will be displayed in the print preview:
iButtonAnnotation
  • Until version 19: The toolbar used to write annotations in the report is visible.
  • From version 20: The "Annotations" button is available in the "Preview" pane. The "Annotate" pane used to write annotations in the report is visible. See "Annotate" pane for more details.
Versions 24 and later
This constant is not taken into account in the mini-preview.
New in version 24
This constant is not taken into account in the mini-preview.
This constant is not taken into account in the mini-preview.
iButtonNone
  • Until version 19: No button or toolbar is displayed.
  • From version 20: Only the "Preview" pane of print preview is displayed. See "Preview" pane for more details.
iButtonReportCreation
  • Until version 19: The button used to create a report with "Reports and Queries" is visible.
Versions 15 and later
iButtonDuplicate
New in version 15
iButtonDuplicate
iButtonDuplicate
  • Until version 19: The button used to save a duplicate copy of current report is visible.
  • From version 20: The "Export" pane is visible. The button used to save a duplicate copy of current report is displayed in the "Export" pane. See "Export" pane for more details.
Versions 24 and later
This constant is not taken into account in the mini-preview.
New in version 24
This constant is not taken into account in the mini-preview.
This constant is not taken into account in the mini-preview.
iButtonEmail
  • Until version 19: The button used to print the report in a new email is visible.
  • From version 20: The "Export" pane is visible. The button used to create an email with the content of integrated report is displayed in the "Export" pane. See "Export" pane for more details.
iButtonEmailPdf
  • Until version 19: The button used to print the report in a file linked to a new email is visible.
  • From version 20: The "Export" pane is visible. The button used to create an email with attached PDF is displayed in the "Export" pane. See "Export" pane for more details.
iButtonExcel
  • Until version 19: The button used to print the report in an Excel file is visible.
  • From version 20: The "Export" pane is visible. The button used to create an Excel file from the current print is displayed in the "Export" pane. See "Export" pane for more details.
Versions 17 and later
iButtonWatermark
New in version 17
iButtonWatermark
iButtonWatermark		The button used to add and configure a text in watermark is visible.
Versions 24 and later
This constant is not taken into account in the mini-preview.
New in version 24
This constant is not taken into account in the mini-preview.
This constant is not taken into account in the mini-preview.
iButtonHtmlThe button used to print the report in an HTML file is visible.
iButtonPrinterThe two buttons used to start the print are visible.
Versions 24 and later
This constant is not taken into account in the mini-preview.
New in version 24
This constant is not taken into account in the mini-preview.
This constant is not taken into account in the mini-preview.
Versions 23 and later
iButtonSnapshot
New in version 23
iButtonSnapshot
iButtonSnapshot		The button used to take a snapshot of report (or report section) is visible.
Versions 24 and later
This constant is not taken into account in the mini-preview.
New in version 24
This constant is not taken into account in the mini-preview.
This constant is not taken into account in the mini-preview.
iButtonReportModificationThe button used to modify the current report with "Reports and Queries" is visible.
Versions 24 and later
This constant is not taken into account in the mini-preview.
New in version 24
This constant is not taken into account in the mini-preview.
This constant is not taken into account in the mini-preview.
Versions 18 and later
iButtonBlackAndWhite
New in version 18
iButtonBlackAndWhite
iButtonBlackAndWhite		The button used to print the document in black and white is visible.
Versions 24 and later
This constant is not taken into account in the mini-preview.
New in version 24
This constant is not taken into account in the mini-preview.
This constant is not taken into account in the mini-preview.
iButtonPdfThe button used to print the report in a PDF file is visible.
Versions 15 and later
iButtonSearch
New in version 15
iButtonSearch
iButtonSearch		The toolbar used to perform a search in the report is visible.
Versions 24 and later
This constant is not taken into account in the mini-preview.
New in version 24
This constant is not taken into account in the mini-preview.
This constant is not taken into account in the mini-preview.
Versions 18 and later
iButtonDuplex
New in version 18
iButtonDuplex
iButtonDuplex		The button used to print the document on both sides is visible.
Versions 24 and later
This constant is not taken into account in the mini-preview.
New in version 24
This constant is not taken into account in the mini-preview.
This constant is not taken into account in the mini-preview.
Versions 18 and later
iButtonTextSelection
New in version 18
iButtonTextSelection
iButtonTextSelection		The button used to select a text is visible.
Versions 24 and later
This constant is not taken into account in the mini-preview.
New in version 24
This constant is not taken into account in the mini-preview.
This constant is not taken into account in the mini-preview.
iButtonAllAll the buttons and toolbars are visible.
iButtonWordThe button used to print the report in a RTF file is visible.
iButtonXmlThe button used to print the report in an XML file is visible.
<Warning>: Optional integer
Number of pages from which a warning message is displayed. This message informs the user that the memory resources of current computer may become insufficient if the remaining pages are displayed.
This parameter is set to 1000 by default.
The message will never be displayed if this parameter is set to 0.
Versions 23 and later

Configure the print preview options Hide the details

iParameterPreview(<Options> , <Display>)
<Options>: Integer constant
Element to configure:
Versions 24 and later
iStorePaneRibbon
New in version 24
iStorePaneRibbon
iStorePaneRibbon		Allows you to store the ribbon pane displayed by the print preview.
By default, the ribbon pane is not stored and the preview is opened on the "Print" pane.
Versions 23 and later
iPaneMiniatures
New in version 23
iPaneMiniatures
iPaneMiniatures		Configure the display of panes for displaying miniatures.
<Display>: Boolean
  • True if the pane of miniatures must be displayed in the print preview,
  • False if the pane of miniatures must not be displayed.
By default, the pane of miniatures is displayed in the print preview.
New in version 23

Configure the print preview options Hide the details

iParameterPreview(<Options> , <Display>)
<Options>: Integer constant
Element to configure:
Versions 24 and later
iStorePaneRibbon
New in version 24
iStorePaneRibbon
iStorePaneRibbon		Allows you to store the ribbon pane displayed by the print preview.
By default, the ribbon pane is not stored and the preview is opened on the "Print" pane.
Versions 23 and later
iPaneMiniatures
New in version 23
iPaneMiniatures
iPaneMiniatures		Configure the display of panes for displaying miniatures.
<Display>: Boolean
  • True if the pane of miniatures must be displayed in the print preview,
  • False if the pane of miniatures must not be displayed.
By default, the pane of miniatures is displayed in the print preview.

Configure the print preview options Hide the details

iParameterPreview(<Options> , <Display>)
<Options>: Integer constant
Element to configure:
Versions 24 and later
iStorePaneRibbon
New in version 24
iStorePaneRibbon
iStorePaneRibbon		Allows you to store the ribbon pane displayed by the print preview.
By default, the ribbon pane is not stored and the preview is opened on the "Print" pane.
Versions 23 and later
iPaneMiniatures
New in version 23
iPaneMiniatures
iPaneMiniatures		Configure the display of panes for displaying miniatures.
<Display>: Boolean
  • True if the pane of miniatures must be displayed in the print preview,
  • False if the pane of miniatures must not be displayed.
By default, the pane of miniatures is displayed in the print preview.
Remarks

Configuring the print preview

  • The configuration defined by iParameterPreview is effective until:
    • the next call to iReset
    • the next call to iParameterPreview.
  • To configure the print preview of all application reports, iParameterPreview must be used in the initialization code of project.
  • The buttons in the preview can also be configured in the report editor ("UI" tab of the report description). In this case, iParameterPreview called before printing the report is used to hide the additional buttons. Buttons that are defined as invisible in the report will always remain invisible.
Remarks:
  • If the print preview allows you to send an email, the email characteristics can be configured by iParameterExport.
  • Versions 23 and later
    The presence (or not) of miniature pane can be configured by programming only.
    New in version 23
    The presence (or not) of miniature pane can be configured by programming only.
    The presence (or not) of miniature pane can be configured by programming only.

Reports not created in the report editor

When printing programmed reports (not created in the report editor), all the buttons found in the button bar are visible.

Warning message (syntax 1)

The warning message is displayed only when a report is printed.
If the user clicks "No" to avoid displaying the following pages, the preview remains opened on the pages that are already displayed. In this case, the entire document is printed (or exported) from the print preview (and not only the pages displayed in the preview).

Configuring the different print modes

You have the ability to configure the options of the different print modes:
Business / UI classification : Neutral code
Component : wd250prn.dll
See also
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment