StandardPrintController.OnEndPrint(PrintDocument, PrintEventArgs) Method

Definition

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Package:

System.Drawing.Common v9.0.0-rc.2.24474.1

Source:

DefaultPrintController.cs

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

Win32Exception

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.

See also

• OnEndPage(PrintDocument, PrintPageEventArgs)
• OnStartPage(PrintDocument, PrintPageEventArgs)
• OnStartPrint(PrintDocument, PrintEventArgs)
• PrintDocument
• PrintEventArgs