Share via


StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Metodo

Definizione

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.

e
PrintPageEventArgs

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.

Si applica a

Vedi anche