PrintPageEventArgs Classe

Definição

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Origem:

PrintPageEventArgs.cs

Fornece dados para o evento PrintPage.

public ref class PrintPageEventArgs : EventArgs

public class PrintPageEventArgs : EventArgs

type PrintPageEventArgs = class
    inherit EventArgs

Public Class PrintPageEventArgs
Inherits EventArgs

Herança

Object

EventArgs

PrintPageEventArgs

Exemplos

O exemplo de código a seguir pressupõe que um Button nome printButton e um PrintDocument nome pd tenham sido criados em um Form. Verifique se o Click evento está Button associado printButton_Click ao método e se o PrintPage evento está PrintDocument associado ao pd_PrintPage método no exemplo. O printButton_Click método do exemplo chama o Print método que gera o PrintPage evento e imprime o arquivo de .bmp especificado no pd_PrintPage método. Para executar este exemplo, altere o caminho para o bitmap que você deseja imprimir.

Use os System.Drawingnamespaces e System.Windows.Forms , System.Drawing.Printingpara este exemplo.

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

Comentários

Observação

No .NET 6 e versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só tem suporte em sistemas operacionais Windows. O uso desse tipo em aplicativos multiplataforma causa avisos de tempo de compilação e exceções em tempo de execução. Para obter mais informações, consulte System.Drawing.Common com suporte apenas no Windows.

A MarginBounds propriedade recupera a área retangular que representa a parte da página entre as margens. A PageBounds propriedade recupera a área retangular que representa a área total da página. A Graphics propriedade define o objeto gráfico com o qual fazer a pintura. A PageSettings propriedade recupera as configurações da impressora para a página atual. As propriedades restantes indicam se um trabalho de impressão deve ser cancelado ou se um trabalho de impressão tem mais páginas.

Para obter mais informações sobre impressão com o Windows Forms, consulte a visão geral do System.Drawing.Printing namespace. Se você quiser imprimir de um aplicativo do Windows Presentation Foundation, consulte o System.Printing namespace.

Construtores

Nome	Description
PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)	Inicializa uma nova instância da classe PrintPageEventArgs.

Propriedades

Nome	Description
Cancel	Obtém ou define um valor que indica se o trabalho de impressão deve ser cancelado.
Graphics	Obtém o Graphics usado para pintar a página.
HasMorePages	Obtém ou define um valor que indica se uma página adicional deve ser impressa.
MarginBounds	Obtém a área retangular que representa a parte da página dentro das margens.
PageBounds	Obtém a área retangular que representa a área total da página.
PageSettings	Obtém as configurações de página da página atual.

Confira também

• Graphics
• Rectangle
• PrintEventArgs