PreviewPrintController.OnStartPage Method (PrintDocument, PrintPageEventArgs)


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

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

public override Graphics OnStartPage(
	PrintDocument document,
	PrintPageEventArgs e


Type: System.Drawing.Printing.PrintDocument

A PrintDocument that represents the document being previewed.

Type: System.Drawing.Printing.PrintPageEventArgs

A PrintPageEventArgs that contains data about how to preview a page in the print document. Initially, the PrintPageEventArgs.Graphics property of this parameter will be null. The value returned from this method will be used to set this property.

Return Value

Type: System.Drawing.Graphics

A Graphics that represents a page from a PrintDocument.

OnStartPage is called immediately before PrintDocument raises the PrintPage event.

OnStartPrint creates the Graphics that is displayed during the print preview. After OnStartPrint is called, the OnStartPage method sets the Graphics to a graphic of a single page. The OnEndPage method clears the Graphics, while the OnEndPrint method deallocates the object.


Anti-aliasing, also known as gray scaling, makes the print preview look better. However, the use of anti-aliasing can slow down the rendering speed. For more information about anti-aliasing, see the UseAntiAlias property.


for safe printing from a restricted dialog box. Associated enumeration: PrintingPermissionLevel.SafePrinting

.NET Framework
Available since 1.1
Return to top