StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Drawing.Printing

Zestaw:: System.Drawing.Common.dll

Zestaw:: System.Drawing.dll

Pakiet:: System.Drawing.Common v6.0.0

Pakiet:: System.Drawing.Common v7.0.0

Pakiet:: System.Drawing.Common v8.0.0

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

Źródło:: DefaultPrintController.cs

Źródło:: DefaultPrintController.cs

Źródło:: DefaultPrintController.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Rozpoczyna sekwencję sterowania, która określa, kiedy i jak wydrukować stronę w dokumencie.

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

Parametry

document: PrintDocument

Obiekt PrintDocument reprezentujący drukowany dokument.

e: PrintPageEventArgs

Element PrintPageEventArgs zawierający dane dotyczące sposobu drukowania strony w dokumencie. Graphics Początkowo właściwość tego parametru będzie mieć nullwartość . Wartość zwrócona OnStartPage(PrintDocument, PrintPageEventArgs) z metody zostanie użyta do ustawienia tej właściwości.

Zwraca

Graphics

Graphics Obiekt reprezentujący stronę z obiektu PrintDocument.

Wyjątki

Win32Exception

Natywny interfejs programowania aplikacji Win32 (API) nie może przygotować sterownika drukarki do akceptowania danych.

-lub-

Natywny interfejs API systemu Windows nie może zaktualizować określonej drukarki lub kontekstu urządzenia plotera (DC) przy użyciu określonych informacji.

Uwagi

OnStartPage jest wywoływana bezpośrednio przed PrintDocument wywołaniem PrintPage zdarzenia.

OnStartPrint Graphics tworzy obiekt używany podczas drukowania. Po OnStartPrint wywołaniu OnStartPage metoda ustawia Graphics obiekt na grafikę pojedynczej strony. Metoda OnEndPage czyści Graphics obiekt, a OnEndPrint metoda cofa przydział obiektu.

Dotyczy