StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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.
A PrintPageEventArgs obsahující data o tom, jak vytisknout stránku v dokumentu. Zpočátku Graphics bude null
vlastnost 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.