Layering Print Output

You can layer print output; for example, when printing a background picture over which is drawn the report itself. This allows multiple drawing and printing over the same area of the printer page, retaining the underlying print image, where possible.

The background area of a control is drawn during an app.printer.print(frame) call if it is not transparent and the following applies.

The backColor property of the control is not set to White
Visible sibling controls occupy the same position within their parents
The value of the backColor property of any of the parents of the control (up to and including the frame in the print method) is not set to White
One of the parents of the control is not a Frame control
The caption property is set for the parent Frame control

This affects existing systems only if the following applies.

The draw methods of the Printer class are followed by executing the print method over the same area. (This is intended to let the drawn image remain, where possible.)
The print method of the Printer class is followed by executing the setPrintPosition method and then the print method over the same area. (This is intended to allow multiple output in the same space, where possible.)
Tables with the value of the backColor property set to White show white table cells as transparent.