StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Avvia la sequenza di controllo che determina quando e come stampare una pagina in un documento.
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 GraphicsParametri
- document
- PrintDocument
Oggetto PrintDocument che rappresenta il documento da stampare.
Oggetto PrintPageEventArgs contenente dati su come stampare una pagina nel documento. Inizialmente, la Graphics proprietà di questo parametro sarà null. Il valore restituito dal OnStartPage(PrintDocument, PrintPageEventArgs) metodo verrà utilizzato per impostare questa proprietà.
Valori restituiti
Oggetto Graphics che rappresenta una pagina da un oggetto PrintDocument.
Eccezioni
L'API (Application Programming Interface) Win32 nativa non è riuscita a preparare il driver della stampante per accettare i dati.
oppure
L'API nativa Windows non è riuscita ad aggiornare la stampante o il contesto del dispositivo plotter specificato usando le informazioni specificate.
Commenti
OnStartPage viene chiamato immediatamente prima PrintDocument di generare l'evento PrintPage .
OnStartPrint crea l'oggetto Graphics utilizzato nella stampa. Dopo OnStartPrint la chiamata, il OnStartPage metodo imposta l'oggetto Graphics su un elemento grafico di una singola pagina. Il OnEndPage metodo cancella l'oggetto Graphics , mentre il OnEndPrint metodo dealloca l'oggetto.
