Sdílet prostřednictvím


StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Metoda

Definice

Zahájí řídicí sekvenci, která určuje, kdy a jak vytisknout stránku v 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

A PrintDocument , který představuje dokument, který se tiskne.

e
PrintPageEventArgs

A PrintPageEventArgs obsahující data o tom, jak vytisknout stránku v dokumentu. Zpočátku Graphics bude nullvlastnost tohoto parametru . Hodnota vrácená metodou OnStartPage(PrintDocument, PrintPageEventArgs) se použije k nastavení této vlastnosti.

Návraty

Objekt Graphics , který představuje stránku z objektu PrintDocument.

Výjimky

Nativní rozhraní API (Application Programming Interface) win32 nemohlo připravit ovladač tiskárny na příjem dat.

-nebo-

Nativní rozhraní API systému Windows nemohlo aktualizovat zadanou tiskárnu nebo kontext plotru zařízení (DC) pomocí zadaných informací.

Poznámky

OnStartPage se volá bezprostředně před PrintDocument vyvolání PrintPage události.

OnStartPrintGraphics vytvoří objekt použitý při tisku. Po OnStartPrint zavolání OnStartPage metoda nastaví Graphics objekt na grafiku jedné stránky. Metoda OnEndPage vymaže Graphics objekt, zatímco OnEndPrint metoda uvolní objekt.

Platí pro

Viz také