PrintPageEventArgs Clase

Definición

Proporciona datos para el evento PrintPage.Provides data for the PrintPage event.

public ref class PrintPageEventArgs : EventArgs
public class PrintPageEventArgs : EventArgs
type PrintPageEventArgs = class
    inherit EventArgs
Public Class PrintPageEventArgs
Inherits EventArgs
Herencia
PrintPageEventArgs

Ejemplos

En el ejemplo de código siguiente Button se printButton presupone que se pd ha creado un denominado y Formque se ha creado un PrintDocument denominado en.The following code example assumes a Button named printButton and a PrintDocument named pd have been created on a Form. Asegúrese de que Click el evento Button de está asociado printButton_Click al método y PrintPage de que el evento de PrintDocument está asociado pd_PrintPage al método en el ejemplo.Make sure the Click event for the Button is associated with the printButton_Click method and the PrintPage event of the PrintDocument is associated with the pd_PrintPage method in the example. El printButton_Click método del ejemplo llama al método Print que genera el PrintPage evento e imprime el archivo. bmp especificado en el pd_PrintPage método.The printButton_Click method from the example calls the Print method raising the PrintPage event, and prints the .bmp file specified in the pd_PrintPage method. Para ejecutar este ejemplo, cambie la ruta de acceso al mapa de bits que desee imprimir.To run this example, change the path to the bitmap you want to print.

Use los System.Drawingespacios System.Drawing.Printingde nombres System.Windows.Forms , y para este ejemplo.Use the System.Drawing, System.Drawing.Printing, and System.Windows.Forms namespaces for this example.

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

La MarginBounds propiedad recupera el área rectangular que representa la parte de la página comprendida entre los márgenes.The MarginBounds property retrieves the rectangular area that represents the portion of the page between the margins. La PageBounds propiedad recupera el área rectangular que representa el área total de la página.The PageBounds property retrieves the rectangular area that represents the total area of the page. La Graphics propiedad define el objeto Graphics con el que se va a realizar el dibujo.The Graphics property defines the graphics object with which to do the painting. La PageSettings propiedad recupera la configuración de impresora de la página actual.The PageSettings property retrieves the printer settings for the current page. 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.The remaining properties indicate whether a print job should be canceled or whether a print job has more pages.

Para obtener más información acerca de la impresión con Windows Forms System.Drawing.Printing , consulte la introducción a los espacios de nombres.For more information about printing with Windows Forms, see the System.Drawing.Printing namespace overview. Si desea imprimir desde una aplicación Windows Presentation Foundation, vea el System.Printing espacio de nombres.If you wish to print from a Windows Presentation Foundation application, see the System.Printing namespace.

Constructores

PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

Inicializa una nueva instancia de la clase PrintPageEventArgs.Initializes a new instance of the PrintPageEventArgs class.

Propiedades

Cancel

Obtiene o establece un valor que indica si se debe cancelar el trabajo de impresión.Gets or sets a value indicating whether the print job should be canceled.

Graphics

Obtiene el objeto Graphics utilizado para dibujar la página.Gets the Graphics used to paint the page.

HasMorePages

Obtiene o establece un valor que indica si se debe imprimir una página adicional.Gets or sets a value indicating whether an additional page should be printed.

MarginBounds

Obtiene el área rectangular que representa la parte de la página comprendida entre los márgenes.Gets the rectangular area that represents the portion of the page inside the margins.

PageBounds

Obtiene el área rectangular que representa el área total de la página.Gets the rectangular area that represents the total area of the page.

PageSettings

Obtiene la configuración de página para la página actual.Gets the page settings for the current page.

Métodos

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también: