OnStartPrint

Begins the control sequence that determines when and how to preview a print document.

Syntax

public override void OnStartPrint (PrintDocument document, PrintEventArgs e)

Parameters

document
A System.Drawing.Printing.PrintDocument that represents the document being previewed.
e
A System.Drawing.Printing.PrintEventArgs that contains data about how to print the document.

Remarks

PreviewPrintController.OnStartPrint(PrintDocument, PrintEventArgs) is called immediately after System.Drawing.Printing.PrintDocument raises the PrintDocument.BeginPrint event.

PreviewPrintController.OnStartPrint(PrintDocument, PrintEventArgs) creates the System.Drawing.Graphics that is displayed during the print preview. After PreviewPrintController.OnStartPrint(PrintDocument, PrintEventArgs) is called, the PreviewPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) method sets the System.Drawing.Graphics to a graphic of a single page. The PreviewPrintController.OnEndPage(PrintDocument, PrintPageEventArgs) method clears the System.Drawing.Graphics, while the PreviewPrintController.OnEndPrint(PrintDocument, PrintEventArgs) method deallocates the object.

PreviewPrintController.OnStartPrint(PrintDocument, PrintEventArgs) verifies that the printer settings are valid.

Requirements

Namespace: System.Drawing.Printing
Assembly: System.Drawing (in System.Drawing.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0