PrintPageEventArgs Classe

Definição

Fornece dados para o PrintPage evento.

public ref class PrintPageEventArgs : EventArgs
public class PrintPageEventArgs : EventArgs
type PrintPageEventArgs = class
    inherit EventArgs
Public Class PrintPageEventArgs
Inherits EventArgs
Herança
PrintPageEventArgs

Exemplos

O exemplo de código seguinte assume que um Button nome printButton e um PrintDocument nome pd foram criados sobre um Form. Certifique-se de que o Click evento para o Button está associado printButton_Click ao método e o PrintPage evento de PrintDocument o está 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 ficheiro .bmp especificado no pd_PrintPage método. Para executar este exemplo, altera o caminho para o bitmap que queres imprimir.

Use os System.Drawingnamespaces , System.Drawing.Printing, e System.Windows.Forms para 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

Observações

Note

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

A MarginBounds propriedade recupera a área retangular que representa a porção 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 que se deve fazer a pintura. A PageSettings propriedade recupera as definiçõ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 mais informações sobre impressão com Windows Forms, consulte a visão geral do espaço de nomes System.Drawing.Printing. Se quiser imprimir a partir de uma aplicação Windows Presentation Foundation, consulte o espaço de nomes System.Printing.

Construtores

Name Description
PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

Inicializa uma nova instância da PrintPageEventArgs classe.

Propriedades

Name Description
Cancel

Recebe ou define um valor que indica se o trabalho de impressão deve ser cancelado.

Graphics

É Graphics usado para pintar a página.

HasMorePages

Recebe ou define um valor que indica se deve ser impressa uma página adicional.

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 definições da página atual.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também