System.Drawing.Printing.PrintDocument.PrintPage Event

Occurs when the output to print for the current page is needed.


public event PrintPageEventHandler PrintPage


To specify the output to print, use the PrintPageEventArgs.Graphics property of the System.Drawing.Printing.PrintPageEventArgs. For example, to specify a line of text that should be printed, draw the text using the erload:System.Drawing.Graphics.DrawString method.

In addition to specifying the output, you can indicate if there are additional pages to print by setting the PrintPageEventArgs.HasMorePages property to true. The default is false, which indicates that there are no more pages to print. Individual page settings can also be modified through the System.Drawing.Printing.PageSettings and the print job can be canceled by setting the PrintPageEventArgs.Cancel property to true. To print each page of a document using different page settings, handle the PrintDocument.QueryPageSettings event.

To associate the event with your event handler, add an instance of the System.Drawing.Printing.PrintPageEventHandler delegate to the event. The event handler is called whenever the event occurs. For more information about handling events with delegates, see [<topic://cpconEventsDelegates>].


Namespace: System.Drawing.Printing
Assembly: System.Drawing (in System.Drawing.dll)
Assembly Versions: 1.0.5000.0,