StandardPrintController.OnEndPage(PrintDocument, PrintPageEventArgs) Method

Definition

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Source:

DefaultPrintController.cs

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

C#

public override void OnEndPage(System.Drawing.Printing.PrintDocument document, System.Drawing.Printing.PrintPageEventArgs e);

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

Win32Exception

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

Applies to

See also

• OnEndPrint(PrintDocument, PrintEventArgs)
• OnStartPage(PrintDocument, PrintPageEventArgs)
• OnStartPrint(PrintDocument, PrintEventArgs)
• PrintDocument
• PrintPage
• PrintPageEventArgs