PreviewPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Method

Definition

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

C#
public override System.Drawing.Graphics OnStartPage(System.Drawing.Printing.PrintDocument document, System.Drawing.Printing.PrintPageEventArgs e);

Parameters

document
PrintDocument

A PrintDocument that represents the document being previewed.

e
PrintPageEventArgs

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

Returns

A Graphics that represents a page from a PrintDocument.

Remarks

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.

Nota

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.

Applies to

Produk Versi
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

See also