iPreview (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Standard functions / Print functions

When should I use iPreview?
Printer fonts
Re-running the report

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

iPreview (Function)

In french: iAperçu

Warning
From version 25, iDestination should be used instead. This function proposes printing via the report viewer (called print preview in previous versions), the mini-preview window, as well as all other print destinations.

Configures the preview window. You can print:

on the printer directly (syntax 1).
in a preview window (syntax 2). The user can preview the print result on the screen, page by page. This window allows you to:
- scroll the pages (next page and previous page if they exist),
- start the print job,
- modify the scale of preview,
- display the first page or the last page,
- find out the number of the current page, ...

Note about compatibility

In the earlier versions, iPreview also allowed you to choose the print destination. These syntaxes have been kept for backward compatibility but iDestination must now be preferred for this use.

Remark: A warning message is displayed by default if the current computer may not have sufficient resources to display all pages in the preview (from 1000 pages). To avoid displaying this message or to configure the number of pages before displaying this message, use iParameterPreview.

The preview window is not available in this version.

Example

See additional examples

Syntax

Printing on the printer directly Hide the details

iPreview([<Destination> [, <Name of the document>]])

<Destination>: Optional integer constant

Print destination.
iPrinter Send document directly to the printer
To directly print on a printer connected to the server, a specific configuration is required. For more details, see Configuring the server to perform a print job.

<Name of the document>: Optional character string

Name that will be given to the print. This name will identify the printout in the list of documents processed by the printer.

Remarks

When should I use iPreview?

iPreview must be the first print function called. It must be called before iPrint, iCreateFont, etc. However, iPreview must be called after iConfigure or iParameter.

Remark: iDestination must be called before printing a report (with iPrintReport) to choose the print destination.

Printer fonts

The printer manufacturers install fonts on their printers. These fonts are called "printer" fonts. Unlike the software fonts (such as "TrueType"), these fonts are directly accessible by the printer, they do not have to be loaded.

In the lists of fonts, the printer fonts are identified by a "printer" icon displayed in front of the name of the font.

If you are using printer fonts, these fonts will be interpreted by the printer only.

Re-running the report

The report displayed in the report viewer is automatically re-run when the report is printed or exported from the report viewer. The WLanguage events associated with report are re-run.

In this case, the data displayed in the report may be modified (to take into account the data modified by the other users for example).

The variables used by the report should be initialized in the report initialization code (not in the code of the Button control that starts the report viewer).

Remark: The WLanguage functions used in your report may return a different result when the report is re-run. For example, if WLanguage functions in your report handle the current window, when the report is re-run, the current window will correspond to the report viewer window.

Business / UI classification: Neutral code

Component: wd300prn.dll