PrintControllerWithStatusDialog.OnStartPage Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

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

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

Element PrintDocument reprezentujący dokument, który jest obecnie drukowany.

e

PrintPageEventArgs

Element PrintPageEventArgs zawierający dane zdarzenia.

Zwraca

Graphics

Graphics Obiekt reprezentujący stronę z obiektu PrintDocument.

Uwagi

Klasa PrintControllerWithStatusDialog wywołuje metodę PrintController.OnStartPage w hermetyzowanej metodzie PrintController.

Metoda jest wywoływana OnStartPage bezpośrednio przed wywołaniem PrintDocumentPrintPage zdarzenia.

Metoda OnStartPrint tworzy Graphics obiekt, który jest wysyłany do drukarki. Po OnStartPrint wywołaniu OnStartPageGraphics ustawia obiekt na grafikę pojedynczej strony. Metoda OnEndPage czyści Graphics obiekt, a OnEndPrint metoda cofa przydział obiektu.

Służy OnStartPage do ustawiania sposobu drukowania strony w dokumencie. Można na przykład dostosować ustawienia strony oddzielnie dla każdej strony.