StandardPrintController.OnEndPage(PrintDocument, PrintPageEventArgs) Method

Definition

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

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

Parameters

document
PrintDocument

A PrintDocument that represents the document being printed.

e
PrintPageEventArgs

A PrintPageEventArgs that contains data about how to print a page in the document.

Exceptions

The native Win32 Application Programming Interface (API) could not finish writing to a page.

Remarks

OnEndPage is called immediately after the PrintDocument raises the PrintPage event. If an exception is thrown inside a PrintPage event of a PrintDocument, OnEndPage is not 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.

When OnEndPage is called from a printing context of a PrintDialog a PrintingPermission of SafePrinting is required. Printing to the default printer requires a PrintingPermission of DefaultPrinting. All other calls this method requires a PrintingPermission of AllPrinting

Security

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

Applies to

See also