StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Methode

Referenz

Definition

Namespace:: System.Drawing.Printing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Paket:: System.Drawing.Common v6.0.0

Paket:: System.Drawing.Common v7.0.0

Paket:: System.Drawing.Common v8.0.0

Paket:: System.Drawing.Common v9.0.0-preview.2.24128.3

Quelle:: DefaultPrintController.cs

Quelle:: DefaultPrintController.cs

Quelle:: DefaultPrintController.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Beginnt die Steuersequenz, durch die bestimmt wird, wann und wie eine Seite eines Dokuments gedruckt wird.

public:
 override System::Drawing::Graphics ^ OnStartPage(System::Drawing::Printing::PrintDocument ^ document, System::Drawing::Printing::PrintPageEventArgs ^ e);

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

override this.OnStartPage : System.Drawing.Printing.PrintDocument * System.Drawing.Printing.PrintPageEventArgs -> System.Drawing.Graphics

Public Overrides Function OnStartPage (document As PrintDocument, e As PrintPageEventArgs) As Graphics

Parameter

document: PrintDocument

Ein PrintDocument, das das Dokument darstellt, das gedruckt wird.

e: PrintPageEventArgs

Ein PrintPageEventArgs, das Daten darüber enthält, wie eine Seite des Dokuments gedruckt wird. Anfangs ist die Graphics-Eigenschaft dieses Parameters null. Der von der OnStartPage(PrintDocument, PrintPageEventArgs)-Methode zurückgegebene Wert wird zum Festlegen dieser Eigenschaft verwendet.

Gibt zurück

Graphics

Ein Graphics-Objekt, das eine Seite eines PrintDocument darstellt.

Ausnahmen

Win32Exception

Die systemeigene Win32-API (Application Programming Interface, Schnittstelle für die Anwendungsprogrammierung) konnte den Druckertreiber nicht darauf vorbereiten, Daten anzunehmen.

- oder -

Die systemeigene Windows-API konnte den für den Drucker oder den Plotter angegebenen Gerätekontext mithilfe der angegebenen Informationen nicht aktualisieren.

Hinweise

OnStartPage wird unmittelbar vor dem PrintDocument Auslösen des Ereignisses PrintPage aufgerufen.

OnStartPrint erstellt das Graphics beim Drucken verwendete Objekt. Nachdem OnStartPrint aufgerufen wurde, legt die OnStartPage -Methode das Graphics -Objekt auf eine Grafik einer einzelnen Seite fest. Die OnEndPage -Methode löscht das Graphics -Objekt, während die OnEndPrint -Methode die Zuordnung des -Objekts aufgibt.

Gilt für:

Freigeben über