Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

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

Parameters

document

A PrintDocument that represents the document currently being printed.

e

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

ADD
Show:
© 2015 Microsoft