Partilhar via


Visão geral do componente PrintDocument (Windows Forms)

O componente Windows Forms PrintDocument é 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 aspetos 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 Windows Form e, em seguida, adicionaria 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 Como imprimir um arquivo de texto de várias páginas no Windows Forms.

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

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

Ver também