Compartir a través de


StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Método

Definición

Comienza la secuencia de control que determina cuándo y cómo imprimir una página en 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

Parámetros

document
PrintDocument

PrintDocument que representa el documento que se está imprimiendo.

e
PrintPageEventArgs

PrintPageEventArgs que contiene los datos referentes a cómo se imprimirá una página en el documento. Al principio, la propiedad Graphics de este parámetro será null. El valor devuelto desde el método OnStartPage(PrintDocument, PrintPageEventArgs) se utilizará para establecer esta propiedad.

Devoluciones

Objeto Graphics que representa una página de PrintDocument.

Excepciones

La interfaz de programación de aplicaciones (API) Win32 nativa no ha podido preparar el controlador de la impresora para aceptar datos.

o bien

La API de Windows nativa no ha podido actualizar el contexto de dispositivo (DC) de impresora o plotter utilizando la información especificada.

Comentarios

OnStartPage se llama inmediatamente antes de PrintDocument generar el PrintPage evento.

OnStartPrint crea el objeto utilizado en la Graphics impresión. Después OnStartPrint de llamar a , el OnStartPage método establece el Graphics objeto en un gráfico de una sola página. El OnEndPage método borra el Graphics objeto, mientras que el OnEndPrint método desasigna el objeto.

Se aplica a

Consulte también