Udostępnij za pośrednictwem


StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Metoda

Definicja

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 Obiekt reprezentujący stronę z obiektu PrintDocument.

Wyjątki

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.

OnStartPrintGraphics 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

Zobacz też