PrintDocument.OnPrintPage(PrintPageEventArgs) Method

Definition

Raises the PrintPage event. It is called before a page prints.

C#
protected internal virtual void OnPrintPage (System.Drawing.Printing.PrintPageEventArgs e);
C#
protected virtual void OnPrintPage (System.Drawing.Printing.PrintPageEventArgs e);

Parameters

e
PrintPageEventArgs

A PrintPageEventArgs that contains the event data.

Remarks

The OnPrintPage method allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

When a derived class calls the OnPrintPage method, it raises the PrintPage event by invoking the event handler through a delegate. For more information, see Handling and Raising Events.

Notes to Inheritors

When overriding OnPrintPage(PrintPageEventArgs) in a derived class, be sure to call the base class's OnPrintPage(PrintPageEventArgs) method so that registered delegates receive the event.

Applies to

Product Versions
.NET 8 (package-provided), 9 (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 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

See also