StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Método
Definición
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.GraphicsPublic Overrides Function OnStartPage (document As PrintDocument, e As PrintPageEventArgs) As GraphicsParámetros
- document
- PrintDocument
que PrintDocument representa el documento que se va a imprimir.
que PrintPageEventArgs contiene datos sobre cómo imprimir una página en el documento. Inicialmente, la Graphics propiedad de este parámetro será null. El valor devuelto desde el OnStartPage(PrintDocument, PrintPageEventArgs) método se usará para establecer esta propiedad.
Devoluciones
Objeto Graphics que representa una página de un PrintDocumentobjeto .
Excepciones
La interfaz de programación de aplicaciones (API) win32 nativa no pudo preparar el controlador de impresora para aceptar datos.
O bien
La API Windows nativa no pudo actualizar el contexto de dispositivo de trazado o impresora especificado mediante la información especificada.
Comentarios
OnStartPage se llama inmediatamente antes de PrintDocument generar el PrintPage evento.
OnStartPrint crea el Graphics objeto usado en la 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 .
