Name
PrintDocument
Synopsis
This class encapsulates a document to be printed.
On construction, the DefaultPageSettings
and
PrinterSettings
represent the default system
printer, but you could create a set of
PageSettings
and assign them to the
DefaultPageSettings
property, and/or a set of
PrinterSettings
, which you assign to the
PrinterSettings
property if you want to customize
the printer output. You can also modify individual properties in the
existing settings (such as the
PrinterSettings.Copies
to change the number of
copies to print). You can also set the
DocumentName
to a display name for the print job.
You’d see this in the printer queue or a status
dialog.
Once the settings are to your satisfaction, you can set a
PrintController
. The default is a
PrintControllerWithStatusDialog
, but you can
choose a StandardPrintController
or a
PreviewPrintController
. Call Print()
to send the document to the printer.
You’re not done yet. To determine what to print, you
have to handle several events raised by the document.
BeginPrint
is raised when printing is started for
the document. Then, the PrintPage
event provides
the System.Drawing.Graphics
object on which to
draw your page, along with a bunch of other settings that allow you
to format the output for the page dimensions and page settings (see
the PrintPageEventArgs
for details). If you have
more pages to print, you can set the HasMorePages
property to true; otherwise, set it to false and the document printing can come to an end. When this ...
Get .NET Windows Forms in a Nutshell now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.