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.Graphics
Public Overrides Function OnStartPage (document As PrintDocument, e As PrintPageEventArgs) As Graphics
Parametri
- document
- PrintDocument
Oggetto PrintDocument che rappresenta il documento da stampare.
Oggetto PrintPageEventArgs che contiene i dati relativi alle modalità di stampa di una pagina nel documento. Inizialmente la proprietà Graphics di questo parametro sarà null
. Il valore restituito dal metodo OnStartPage(PrintDocument, PrintPageEventArgs) sarà utilizzato per impostare la proprietà.
Restituisce
Oggetto Graphics che rappresenta una pagina di un PrintDocument.
Eccezioni
L'API Win32 nativa non ha completato la preparazione del driver di stampa per accettare i dati.
-oppure-
L'API Windows nativa non ha completato l'aggiornamento del contesto di periferica (DC) della stampante o del plotter specificato usando le informazioni specificate.
Commenti
OnStartPage viene chiamato immediatamente prima PrintDocument che generi 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.