PrintController.OnStartPage Method

When overridden in a derived class, begins 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 Overridable Function OnStartPage ( _
	document As PrintDocument, _
	e As PrintPageEventArgs _
) As Graphics
Dim instance As PrintController
Dim document As PrintDocument
Dim e As PrintPageEventArgs
Dim returnValue As Graphics

returnValue = instance.OnStartPage(document, e)
public Graphics OnStartPage (
	PrintDocument document, 
	PrintPageEventArgs e
public function OnStartPage (
	document : PrintDocument, 
	e : PrintPageEventArgs
) : Graphics
Not applicable.



A PrintDocument that represents the document currently being printed.


A PrintPageEventArgs that contains the event data.

Return Value

A Graphics that represents a page from a PrintDocument.

OnStartPage is called immediately before the PrintDocument raises the PrintPage event.

OnStartPrint creates the Graphics that is sent to the printer. 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.

Use the OnStartPage method to set how to print a page in a document. For example, you can adjust page settings separately for each page.

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

Community Additions