StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee begint u de besturingsreeks die bepaalt wanneer en hoe u een pagina in een document afdrukt.
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.GraphicsPublic Overrides Function OnStartPage (document As PrintDocument, e As PrintPageEventArgs) As GraphicsParameters
- document
- PrintDocument
Een PrintDocument document dat wordt afgedrukt.
Een PrintPageEventArgs met gegevens over het afdrukken van een pagina in het document. In eerste instantie is Graphicsde null eigenschap van deze parameter. De waarde die door de OnStartPage(PrintDocument, PrintPageEventArgs) methode wordt geretourneerd, wordt gebruikt om deze eigenschap in te stellen.
Retouren
Een Graphics object dat een pagina van een PrintDocument.
Uitzonderingen
De systeemeigen Win32 Application Programming Interface (API) kan het printerstuurprogramma niet voorbereiden om gegevens te accepteren.
– of –
De systeemeigen Windows-API kan de opgegeven printer- of plotterapparaatcontext (DC) niet bijwerken met behulp van de opgegeven informatie.
Opmerkingen
OnStartPage wordt onmiddellijk aangeroepen voordat PrintDocument de PrintPage gebeurtenis wordt gegenereerd.
OnStartPrint maakt het Graphics object dat wordt gebruikt bij het afdrukken. Nadat OnStartPrint deze is aangeroepen, wordt het OnStartPage object door de Graphics methode ingesteld op een afbeelding van één pagina. Met OnEndPage de methode wordt het Graphics object gewist, terwijl de OnEndPrint methode de toewijzing van het object ongedaan wordt gemaakt.
