PrintDocument.OnBeginPrint(PrintEventArgs) Method

Definition

Raises the BeginPrint event. It is called after the Print() method is called and before the first page of the document prints.

C#
protected internal virtual void OnBeginPrint(System.Drawing.Printing.PrintEventArgs e);
C#
protected virtual void OnBeginPrint(System.Drawing.Printing.PrintEventArgs e);

Parameters

e
PrintEventArgs

A PrintEventArgs that contains the event data.

Remarks

The OnBeginPrint 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 OnBeginPrint method, it raises the BeginPrint event by invoking the event handler through a delegate. For more information, see Handling and Raising Events.

Notes to Inheritors

When overriding OnBeginPrint(PrintEventArgs) in a derived class, be sure to call the base class's OnBeginPrint(PrintEventArgs) method so that registered delegates receive the event. This method is a good place for initialization.

Applies to

Product Versions
.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