ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Standard functions / Print functions
  • Common errors
  • Limitations
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Prints a duplicate copy of a report. This duplicate copy can be printed:
  • in the report viewer,
  • on the printer,
  • in a file (pdf, ...).
This duplicate copy was created:
  • explicitly by iDestination (associated with the iDuplicate constant).
  • directly from the report viewer (duplicate print option or iParameterDuplicate before starting the report viewer).
Remark: It is possible to retrieve the list of duplicates created for the current print run using the iLastFile function..
Example
// Create the duplicate copy
iDestination(iDuplicate, "C:\Temp\MyDuplicate.dpl")
iPrintReport(RPT_Invoice)
 
// Print the duplicate copy in the report viewer
iDestination(iViewer)
iPrintDuplicate("C:\Temp\MyDuplicate.dpl")
// Configure the duplicate copies performed from the report viewer
iParameterDuplicate(iDplPrintout, "C:\Temp", "MyDuplicate_%d_%h", "MMDDYYYY", "HHMMSS")
 
// Print a duplicate via the report viewer
iDestination(iViewer)
iPrintReport(RPT_Invoice)
 
// Browse the duplicate copies automatically created from the report viewer
sListDuplicates is string
sListDuplicates = iLastFile(iDuplicate)
sDuplicate is string
sDuplicate = ExtractString(sListDuplicates, firstRank, CR)
WHILE sDuplicate <> EOT
// Print the duplicate
iPrintDuplicate(sDuplicate)
// Go to the next duplicate
sDuplicate = ExtractString(sListDuplicates, nextRank, CR)
END
Syntax
<Result> = iPrintDuplicate(<Duplicate file> [, <Password>])
<Result>: Boolean
  • True if the duplicate copy was printed,
  • False otherwise. To get more details on the error, use ErrorInfo.
<Duplicate file>: Character string
Name of the duplicate file (.dpl file) to print. The duplicate file is sought in the current directory by default. The full path of the duplicate file to print can be specified if necessary.
<Password>: Optional character string or secret string
Password of duplicate file to print. This password must be identical to the one used when creating the duplicate copy.
New in version 2025
Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "Ansi or Unicode string".
To learn more about secret strings and how to use the vault, see Secret string vault.
Remarks

Common errors

The common errors that can occur are as follows:
  • 90025: Wrong password. The password used to create the duplicate file differs from the password used to open the duplicate file.
  • 90026: Wrong format. The format of the duplicate file is incorrect. It is corrupt.
  • 90027: Version too recent. The duplicate file was generated with a WINDEV or WEBDEV version that is more recent that the version used to read the duplicate file.

Limitations

  • iEndPrinting must not be used with iPrintDuplicate.
  • The print functions must not be used when printing a duplicate. For example, the following code must not be used:
    iDestination(iViewer)
    iPrint("This is forbidden")
    iPrintDuplicate("C:\Temp\MyDuplicate.dpl")
Business / UI classification: Neutral code
Component: wd300prn.dll
Minimum version required
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 11/23/2024

Send a report | Local help