StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Börjar kontrollsekvensen som avgör när och hur du skriver ut en sida i ett dokument.
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 GraphicsParametrar
- document
- PrintDocument
En PrintDocument som representerar dokumentet som skrivs ut.
En PrintPageEventArgs som innehåller data om hur du skriver ut en sida i dokumentet. Inledningsvis är nullegenskapen för den Graphics här parametern . Värdet som returneras från OnStartPage(PrintDocument, PrintPageEventArgs) metoden används för att ange den här egenskapen.
Returer
Ett Graphics objekt som representerar en sida från en PrintDocument.
Undantag
Det inbyggda Api:et (Application Programming Interface) för Win32 kunde inte förbereda skrivardrivrutinen för att acceptera data.
-eller-
Det interna Windows-API:et kunde inte uppdatera den angivna skrivar- eller plotterenhetskontexten (DC) med hjälp av den angivna informationen.
Kommentarer
OnStartPage anropas omedelbart innan PrintDocument händelsen PrintPage höjs.
OnStartPrint skapar objektet Graphics som används vid utskrift. När OnStartPrint har anropats OnStartPage anger Graphics metoden objektet till en bild av en enda sida. Metoden OnEndPage rensar Graphics objektet medan OnEndPrint metoden frigör objektet.