Compartilhar via


Visão geral do componente PrintDocument (Windows Forms)

O componente PrintDocument do 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 componente PrintDocument são:

  • Trabalhos de impressão simples, como imprimir um arquivo de texto individual. Nesse caso, você adicionaria o componente PrintDocument a um Formulário do Windows e adicionaria uma lógica de programação que imprime um arquivo no manipulador de eventos PrintPage. A lógica de programação deve culminar com o método Print para imprimir o documento. Esse método envia um objeto Graphics, contido na propriedade Graphics da classe PrintPageEventArgs, para a impressora. Para obter um exemplo que mostra como imprimir um documento de texto usando o componente PrintDocument, consulte How to: Print a Multi-Page Text File in 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 substituiria (consulte Substituições para Visual Basic ou substituir 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