setPrintPosition

setPrintPosition(pos: Integer) updating;

The setPrintPosition method of the Printer class sets the next print position to be used. (The position is zero-relative to the top margin of the page.)

This method enables logic to print a left panel, reset to a specified position, and then print a right panel, for example.

The position specified in the pos parameter must be greater than or equal to zero (0) and less than the value returned by the app.printer.pageHeight method. The print position can be anywhere on the page, including being reset to line positions that have already been printed on.

If the value specified in the pos parameter is less than zero (0) or greater than or equal to the value returned by the app.printer.pageHeight method, an error is returned.

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

This method is not relevant for direct printing (that is, when the formatOut property option is set to =direct).

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