Partilhar via

Como: Criar trabalhos de impressão padrão do Windows Forms

  • Artigo

A base da impressão no Windows Forms é o componente PrintDocument — mais especificamente, o evento PrintPage. Ao escrever código para manipular o evento PrintPage, você pode especificar o que imprimir e como imprimi-lo.

Para criar um trabalho de impressão

  1. Adicione um componente PrintDocument ao formulário.

  2. Escreva código para manipular o evento PrintPage.

    Você terá que codificar sua própria lógica de impressão. Além disso, você terá que especificar o material a ser impresso.

    No exemplo de código a seguir, um gráfico de exemplo na forma de um retângulo vermelho é criado no manipulador de eventos PrintPage para atuar como material a ser impresso.

    Private Sub PrintDocument1_PrintPage(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintPageEventArgs) Handles PrintDocument1.PrintPage  
   e.Graphics.FillRectangle(Brushes.Red, New Rectangle(500, 500, 500, 500))  
End Sub  

    private void printDocument1_PrintPage(object sender,
System.Drawing.Printing.PrintPageEventArgs e)  
{  
   e.Graphics.FillRectangle(Brushes.Red,
     new Rectangle(500, 500, 500, 500));  
}  

    private:  
   void printDocument1_PrintPage(System::Object ^ sender,  
      System::Drawing::Printing::PrintPageEventArgs ^ e)  
   {  
      e->Graphics->FillRectangle(Brushes::Red,  
         Rectangle(500, 500, 500, 500));  
   }

    (Visual C# e Visual C++) Coloque o código a seguir no construtor do formulário para registrar o manipulador de eventos.

    this.printDocument1.PrintPage += new  
   System.Drawing.Printing.PrintPageEventHandler  
   (this.printDocument1_PrintPage);  

    printDocument1->PrintPage += gcnew  
   System::Drawing::Printing::PrintPageEventHandler  
   (this, &Form1::printDocument1_PrintPage);

    Você também pode escrever código para os eventos BeginPrint e EndPrint, talvez incluindo um inteiro representando o número total de páginas a serem impressas que é diminuído à medida que cada página é impressa.

    Observação

    Você pode adicionar um componente PrintDialog ao formulário para fornecer uma interface do usuário (UI) limpa e eficiente aos usuários. Definir a propriedade Document do componente PrintDialog permite definir propriedades relacionadas ao documento de impressão com o qual você está trabalhando no formulário. Para obter mais informações sobre o componente PrintDialog, consulte o componente PrintDialog .

    Para obter mais informações sobre as especificidades dos trabalhos de impressão do Windows Forms, incluindo como criar um trabalho de impressão programaticamente, consulte PrintPageEventArgs.

Ver também