QPenPrinter allows Pen to operate on a printer device. The graphics can be exported to PDF by using "print to file" as printer device.
Create a new QPenPrinter object.
an instance of QPenPrinter
Convenience function to show a print dialog and print.
| printFunc |
A Function to be evaluated when the user presses "Print", with the printer object as Pen painter target. See aPrintFunc in -print below. |
| cancelFunc |
An optional Function to be evaluated if the user presses "Cancel". |
Shows a Print Dialog to allow the user to configure the printer object. This is asynchronous and the method will return immediately. When the user presses the "Print" button, aOkFunc is called with this QPenPrinter object as argument.
| aOkFunc |
A Function to be evaluated when the user presses "Print". |
| aCancelFunc |
An optional Function to be evaluated if the user presses "Cancel". |
This method does the actual printing or PDF export. It evaluates aPrintFunc with the printer object as Pen painter target. This QPenPrinter object is passed as the argument.
All the ordinary Pen commands can be used inside the function.
| aPrintFunc |
A Function to be evaluated to draw the graphics. |
If this method is called without configuring the printer object first, it will print on the default printer with default settings.
This method is typically called from within the aOkFunc of -showDialog above. After showDialog has configured the printer once, this method can be called multiple times to reuse the last printer configuration.
The point at (0@0) will coincide with the origin of -pageRect, which is offset by the page margins. So you don't need to translate the Pen.
Starts a new page. Typically called within the aPrintFunc of -print.
Get the page bounds, which is the printable area and usually smaller than -paperRect due to margins.
a Rect
The origin of the Rect is relative to the paper, and will be non-zero due to margins.
Get the page size as a Size.
a Size
This can be used to scale the graphics to fit the page if the bounds of the graphics is known:
The methods below returns the page range selected by the user. Page number starts at 1. When both methods returns 0 it means "print all pages".
Simple usage:
Keep the QPenPrinter object to save configuration state:
The code below can then be called multiple times: