PrintPageEventArgs Clase

Definición

Espacio de nombres:

System.Drawing.Printing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Source:

PrintPageEventArgs.cs

Proporciona datos para el evento PrintPage.

public ref class PrintPageEventArgs : EventArgs

public class PrintPageEventArgs : EventArgs

type PrintPageEventArgs = class
    inherit EventArgs

Public Class PrintPageEventArgs
Inherits EventArgs

Herencia

Object

EventArgs

PrintPageEventArgs

Ejemplos

En el ejemplo de código siguiente se supone que se ha creado un Button denominado printButton y un PrintDocument con nombre pd en .Form Asegúrese de que el Click evento de Button está asociado al printButton_Click método y el PrintPage evento de PrintDocument está asociado al pd_PrintPage método en el ejemplo. El printButton_Click método del ejemplo llama al Print método que genera el PrintPage evento e imprime el archivo .bmp especificado en el pd_PrintPage método . Para ejecutar este ejemplo, cambie la ruta de acceso al mapa de bits que desea imprimir.

Use los System.Drawingespacios de nombres , System.Drawing.Printingy System.Windows.Forms para este ejemplo.

private:
   // Specifies what happens when the user clicks the Button.
   void printButton_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      try
      {
         pd->Print();
      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( "An error occurred while printing", ex->ToString() );
      }
   }

   // Specifies what happens when the PrintPage event is raised.
   void pd_PrintPage( Object^ /*sender*/, PrintPageEventArgs^ ev )
   {
      // Draw a picture.
      ev->Graphics->DrawImage( Image::FromFile( "C:\\My Folder\\MyFile.bmp" ),
         ev->Graphics->VisibleClipBounds );
      
      // Indicate that this is the last page to print.
      ev->HasMorePages = false;
   }

// Specifies what happens when the user clicks the Button.
 private void printButton_Click(object sender, EventArgs e) 
 {
   try 
   {
     // Assumes the default printer.
     pd.Print();
   }  
   catch(Exception ex) 
   {
     MessageBox.Show("An error occurred while printing", ex.ToString());
   }
 }
 
 // Specifies what happens when the PrintPage event is raised.
 private void pd_PrintPage(object sender, PrintPageEventArgs ev) 
 {      
   // Draw a picture.
   ev.Graphics.DrawImage(Image.FromFile("C:\\My Folder\\MyFile.bmp"), ev.Graphics.VisibleClipBounds);
      
   // Indicate that this is the last page to print.
   ev.HasMorePages = false;
 }

' Specifies what happens when the user clicks the Button.
Private Sub printButton_Click(sender As Object, e As EventArgs) _
Handles printButton.Click
    Try
       pd.Print()
    Catch ex As Exception
        MessageBox.Show("An error occurred while printing", _
            ex.ToString())
    End Try
End Sub    

' Specifies what happens when the PrintPage event is raised.
Private Sub pd_PrintPage(sender As Object, ev As PrintPageEventArgs) _
Handles pd.PrintPage

    ' Draw a picture.
    ev.Graphics.DrawImage(Image.FromFile("C:\My Folder\MyFile.bmp"), _
        ev.Graphics.VisibleClipBounds)
    
    ' Indicate that this is the last page to print.
    ev.HasMorePages = False
End Sub

Comentarios

Nota

En .NET 6 y versiones posteriores, el paquete System.Drawing.Common, que incluye este tipo, solo se admite en sistemas operativos Windows. El uso de este tipo en aplicaciones multiplataforma provoca advertencias en tiempo de compilación y excepciones en tiempo de ejecución. Para obtener más información, vea System.Drawing.Common solo compatible con Windows.

La MarginBounds propiedad recupera el área rectangular que representa la parte de la página entre los márgenes. La PageBounds propiedad recupera el área rectangular que representa el área total de la página. La Graphics propiedad define el objeto gráfico con el que se va a realizar la pintura. La PageSettings propiedad recupera la configuración de la impresora de la página actual. Las propiedades restantes indican si se debe cancelar un trabajo de impresión o si un trabajo de impresión tiene más páginas.

Para obtener más información sobre la impresión con Windows Forms, consulte la introducción al System.Drawing.Printing espacio de nombres. Si desea imprimir desde una aplicación de Windows Presentation Foundation, consulte el System.Printing espacio de nombres .

Constructores

PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

Inicializa una nueva instancia de la clase PrintPageEventArgs.

Propiedades

Cancel	Obtiene o establece un valor que indica si se debe cancelar el trabajo de impresión.
Graphics	Obtiene el objeto Graphics utilizado para dibujar la página.
HasMorePages	Obtiene o establece un valor que indica si se debe imprimir una página adicional.
MarginBounds	Obtiene el área rectangular que representa la parte de la página comprendida entre los márgenes.
PageBounds	Obtiene el área rectangular que representa el área total de la página.
PageSettings	Obtiene la configuración de página para la página actual.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• Graphics
• Rectangle
• PrintEventArgs