StandardPrintController.OnEndPrint Method (PrintDocument, PrintEventArgs)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Completes the control sequence that determines when and how to print a document.

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

public override void OnEndPrint(
	PrintDocument document,
	PrintEventArgs e
)

Parameters

document
Type: System.Drawing.Printing.PrintDocument

A PrintDocument that represents the document being printed.

e
Type: System.Drawing.Printing.PrintEventArgs

A PrintEventArgs that contains data about how to print the document.

Exception Condition
Win32Exception

The native Win32 Application Programming Interface (API) could not complete the print job.

-or-

The native Win32 API could not delete the specified device context (DC).

OnEndPrint is called immediately after PrintDocument raises the EndPrint event. Even if an uncaught exception was thrown during the printing process, OnEndPrint is called.

OnStartPrint creates the Graphics object that is sent to the printer. After OnStartPrint is called, the OnStartPage method sets the Graphics object to a graphic of a single page. The OnEndPage method clears the Graphics object, while the OnEndPrint method deallocates the object.

PrintingPermission

for controlling access to printers. Related enumeration: PrintingPermissionLevel.

.NET Framework
Available since 1.1
Return to top
Show: