StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Método

Referencia

Definición

Espacio de nombres:: System.Drawing.Printing

Ensamblado:: System.Drawing.Common.dll

Ensamblado:: System.Drawing.dll

Paquete:: System.Drawing.Common v6.0.0

Paquete:: System.Drawing.Common v7.0.0

Paquete:: System.Drawing.Common v8.0.0

Paquete:: System.Drawing.Common v9.0.0-preview.2.24128.3

Source:: DefaultPrintController.cs

Source:: DefaultPrintController.cs

Source:: DefaultPrintController.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

Graphics

Objeto Graphics que representa una página de PrintDocument.

Excepciones

Win32Exception

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

Compartir vía