This class represents the Windows or PostScript printer, and is the vehicle through
which printing may be launched by an application. Printing can also
be achieved through using of lower functions and classes, but
this and associated classes provide a more convenient and general
method of printing.
Printing framework overview, PrinterDC, PrintDialog, Printout, PrintPreview.
Constructor. Pass an optional pointer to a block of print
dialog data, which will be copied to the printer object’s local data.
Creates the default printing abort window, with a cancel button.
Returns true if the user has aborted the print job.
Return last error. Valid after calling Print,
print_dialog or
PrintPreview#print. These functions
set last error to PRINTER_NO_ERROR if no error happened.
Returned value is one of the following:
PRINTER_NO_ERROR | No error happened. |
PRINTER_CANCELLED | The user cancelled printing. |
PRINTER_ERROR | There was an error during printing. |
Returns the print data associated with the printer object.
Starts the printing process. Provide a parent window, a user-defined Printout object which controls
the printing of a document, and whether the print dialog should be invoked first.
Print could return false if there was a problem initializing the printer device context
(current printer not set, for example) or the user cancelled printing. Call
Printer#get_last_error to get detailed
information about the kind of the error.
Invokes the print dialog. If successful (the user did not press Cancel
and no error occurred), a suitable device context will be returned
(otherwise NULL is returned — call
Printer#get_last_error to get detailed
information about the kind of the error).
The application must delete this device context to avoid a memory leak.
Default error-reporting function.
Invokes the print setup dialog. Note that the setup dialog is obsolete from
Windows 95, though retained for backward compatibility.
[This page automatically generated from the Textile source at 2023-06-09 00:45:35 +0000]