print

print(win: Frame input): Integer updating;

The print method of the Printer class outputs the frame specified in the win parameter to the printer. The space used by the frame on the printed page is determined by the currently set height of the frame (that is, it can be changed during printing) rather than the height of the frame that was painted during the form definition in the JADE Painter.

An exception is raised if this method is invoked from a server method.

For details about calling the print method when printing a background picture over which is drawn the report itself, see "Layering Print Output", earlier in this section.

The Printer category global constants that can be returned by the print method are listed in the following table.

If a value of 15015 or 15016 is returned (that is, printing was canceled or stopped), the printer has been closed and code is required in your method to logically end the print processing.

The following example shows the use of the print method.

buttonPrint_click(btn: Button input) updating;
vars
    result : Integer;
    report : ReportForm;
begin
    // Creates ReportForm transient class instance and references it by the
    // report local variable, which can be used to access the form controls.
    create report;
    // Specifies output is not directed to the preview file before printing.
    app.printer.printPreview := false;
    // Specifies the format of the pages to be printed.  As these are
    // default values, it is unnecessary to redefine them unless you
    // require a different format.
    app.printer.orientation  := Print_Portrait;
    app.printer.documentType := Print_A4;
    // Uses the print method to output frame2 of the form to the print
    // file twice.  The return value is stored in the result local
    // variable, and is checked to ensure that the print task has not
    // been stopped or cancelled.  The method returns if this is the case.
    // The close method then sends all buffered output to the printer
    // that prints the document.
    result := app.printer.print(report.frame2);
    if result = Print_Stopped or result = Print_Cancelled then
        return;
    endif;
    result := app.printer.print(report.frame2);
    if result = Print_Stopped or result = Print_Cancelled then
        return;
    endif;
epilog
    app.printer.close;
    delete report;      // Deletes the transient form instance.
end;

VERSION 2018.0.01  |  Copyright © 2018  Jade Software Corporation Limited.  All rights reserved.