PrintPage Event
Collapse the table of content
Expand the table of content

PrintDocument.PrintPage Event

 

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

Namespace:   System.Drawing.Printing
Assembly:  System.Drawing (in System.Drawing.dll)

member PrintPage : IEvent<PrintPageEventHandler,
    PrintPageEventArgs>

To specify the output to print, use the Graphics property of the PrintPageEventArgs. For example, to specify a line of text that should be printed, draw the text using the 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 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 QueryPageSettings event.

To associate the event with your event handler, add an instance of the PrintPageEventHandler delegate to the event. The event handler is called whenever the event occurs. For more information about handling events with delegates, see Handling and Raising Events.

The following code example demonstrates handling the PrintPage event.

For another example, see How to: Print a Multi-Page Text File in Windows Forms.

Use the System.Drawing, System.Drawing.Printing, and System.IO namespaces for this example.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show:
© 2016 Microsoft