Compartilhar via

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

  • Artigo

O fundamento da impressão nos Formulários do Windows é 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 imprimir.

Para criar um trabalho de impressão

  1. Adicione um componente PrintDocument ao seu formulário.

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

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

    No código exemplo a seguir, uma amostra de gráfico 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 seguinte código 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);

    Convém também 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 é decrementado cada vez que uma página é impressa.

    ObservaçãoObservação

    Você pode adicionar um componente PrintDialog ao seu formulário para prover uma interface do usuário (IU) limpa e eficiente. Definir a propriedade Document do componente PrintDialog permite que você defina propriedades relacionadas ao documento de impressão com que você está trabalhando no seu formulário. Para mais informações sobre o componente PrintDialog. consulte Componente PrintDialog (Windows Forms).

    Para mais informações sobre as especificidades dos trabalhos de impressão dos Formulários do Windows, inclusive como criar um trabalho de impressão via programação, consulte PrintPageEventArgs.

Consulte também

Referência

PrintDocument

Outros recursos

Suporte a Impressão em Formulários do Windows