Compartilhar via


Visão geral do componente PrintDocument (Windows Forms)

O componente PrintDocument dos Windows Forms é usado para definir as propriedades que descrevem o que imprimir e a capacidade de imprimir o documento em aplicativos baseados no Windows. Ele pode ser usado em conjunto com o componente PrintDialog para controlar todos os aspectos da impressão de documentos.

Trabalhando com o componente PrintDocument

Dois dos principais cenários que envolvem o PrintDocument componente são:

  • Trabalhos de impressão simples, como imprimir um arquivo de texto individual. Nesse caso, você adicionaria o PrintDocument componente a um Formulário do Windows e adicionaria uma lógica de programação que imprime um arquivo no PrintPage manipulador de eventos. A lógica de programação deve culminar com o Print método para imprimir o documento. Esse método envia um Graphics objeto, contido na Graphics propriedade da PrintPageEventArgs classe, para a impressora. Para obter um exemplo que mostra como imprimir um documento de texto usando o PrintDocument componente, consulte Como imprimir um arquivo de texto de várias páginas nos Windows Forms.

  • Trabalhos de impressão mais complexos, como uma situação em que você desejará reutilizar a lógica de impressão que você escreveu. Nesse caso, você derivaria um novo componente do componente PrintDocument e sobrescreveria (consulte Substituições para Visual Basic ou substituição para C#) o evento PrintPage.

Quando ele é adicionado a um formulário, o componente PrintDocument aparece na bandeja na parte inferior do Designer de Formulários do Windows no Visual Studio.

Consulte também