PreviewPrintController.OnStartPage Method

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
public Graphics OnStartPage (
	PrintDocument document, 
	PrintPageEventArgs e
public override function OnStartPage (
	document : PrintDocument, 
	e : PrintPageEventArgs
) : Graphics
Not applicable.



A PrintDocument that represents the document being previewed.


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 a null reference (Nothing in Visual Basic). The value returned from this method will be used to set this property.

Return Value

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.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0