StandardPrintController.OnEndPage Method (PrintDocument, PrintPageEventArgs)

 

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

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

public override void OnEndPage(
	PrintDocument document,
	PrintPageEventArgs e
)

Parameters

document
Type: System.Drawing.Printing.PrintDocument

A PrintDocument that represents the document being printed.

e
Type: System.Drawing.Printing.PrintPageEventArgs

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

Exception Condition
Win32Exception

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

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

PrintingPermission

for controlling access to printers. Related enumeration: PrintingPermissionLevel.

.NET Framework
Available since 1.1
Return to top
Show: