PrintControllerWithStatusDialog.OnEndPage 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 currently being printed.

e
PrintPageEventArgs

A PrintPageEventArgs that contains the event data.

Remarks

The PrintControllerWithStatusDialog class calls the PrintController.OnEndPage method on the encapsulated PrintController.

The OnEndPage method 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.

The OnStartPrint method 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. (Use OnStartPage to set how to print a page in a document. For example, you can adjust page settings separately for each page.) OnEndPage clears the Graphics object, while the OnEndPrint method deallocates the object.

Applies to