StandardPrintController.OnEndPrint(PrintDocument, PrintEventArgs) Method

Definition

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

public:
 override void OnEndPrint(System::Drawing::Printing::PrintDocument ^ document, System::Drawing::Printing::PrintEventArgs ^ e);
public override void OnEndPrint (System.Drawing.Printing.PrintDocument document, System.Drawing.Printing.PrintEventArgs e);
override this.OnEndPrint : System.Drawing.Printing.PrintDocument * System.Drawing.Printing.PrintEventArgs -> unit
Public Overrides Sub OnEndPrint (document As PrintDocument, e As PrintEventArgs)

Parameters

document
PrintDocument

A PrintDocument that represents the document being printed.

e
PrintEventArgs

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

Exceptions

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

-or-

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

Remarks

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.

Security

PrintingPermission
for controlling access to printers. Related enumeration: PrintingPermissionLevel.

Applies to

See also