StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Methode
Definition
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 mit der Steuerelementsequenz, die bestimmt, wann und wie eine Seite in einem Dokument 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.GraphicsPublic Overrides Function OnStartPage (document As PrintDocument, e As PrintPageEventArgs) As GraphicsParameter
- document
- PrintDocument
Ein PrintDocument Wert, der das zu druckde Dokument darstellt.
A PrintPageEventArgs that contains data about how to print a page in the document. Zunächst lautet Graphicsdie null Eigenschaft dieses Parameters . Der von der OnStartPage(PrintDocument, PrintPageEventArgs) Methode zurückgegebene Wert wird verwendet, um diese Eigenschaft festzulegen.
Gibt zurück
Ein Graphics Objekt, das eine Seite aus einer PrintDocument.
Ausnahmen
Die systemeigene Win32 Application Programming Interface (API) konnte den Druckertreiber nicht auf die Annahme von Daten vorbereiten.
-oder-
Die systemeigene Windows-API konnte den angegebenen Drucker- oder Plottergerätekontext (DC) nicht mithilfe der angegebenen Informationen aktualisieren.
Hinweise
OnStartPage wird unmittelbar vor PrintDocument dem Auslösen des Ereignisses PrintPage aufgerufen.
OnStartPrint erstellt das objekt, das Graphics beim Drucken verwendet wird. Nach OnStartPrint dem Aufruf 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 Methode die OnEndPrint Zuordnung des Objekts behandelt.
