StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Metoda
Definicja
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.
Element PrintPageEventArgs zawierający dane dotyczące sposobu drukowania strony w dokumencie. Graphics Początkowo właściwość tego parametru będzie mieć null
wartość . 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.