PrintPageEventArgs Classe

Definição

Fornece dados para o evento de PrintPage .

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 a seguir pressupõe que um Button nomeado printButton e um PrintDocument nomeado pd foram criados em um Form. Verifique se o Click evento para o Button está associado printButton_Click ao método e se o PrintPage evento do PrintDocument está associado ao pd_PrintPage método no exemplo. O printButton_Click método do exemplo chama o Print método que aciona o PrintPage evento e imprime o arquivo .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 , System.Drawing.Printinge 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

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 Windows Forms, consulte a visão geral do System.Drawing.Printing namespace. Se você quiser imprimir de um aplicativo Windows Presentation Foundation, consulte o System.Printing namespace.

Construtores

PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

Inicializa uma nova instância da classe PrintPageEventArgs.

Propriedades

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.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também