.NET Windows Forms in a Nutshell

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 ...