Общие сведения о компоненте PrintDocument (Windows Forms)

Компонент Windows Forms PrintDocument позволяет определять свойства, описывающие печатаемое содержимое, и распечатывать документы в приложениях Windows. Его можно использовать в сочетании с компонентом PrintDialog для управления всеми аспектами печати документов.

Работа с компонентом PrintDocument

Ниже приведены два из нескольких основных сценариев использования компонента PrintDocument.

  • Простые задания печати, такие как печать отдельного текстового файла. В этом случае вы добавляете компонент PrintDocument в Windows Form, а затем добавляете логику программирования, которая выводит файл в обработчике событий PrintPage. Логика программирования должна завершаться методом Print для печати документа. Этот метод отправляет объект Graphics, содержащийся в свойстве Graphics класса PrintPageEventArgs, на принтер. Пример печати текстового документа с помощью компонента PrintDocument см. в документе Практическое руководство. Печать многостраничных текстовых файлов в Windows Forms.

  • Более сложные задания печати, например ситуации, когда требуется повторное использование уже написанной логики печати. В этом случае вы создадите компонент, производный от компонента PrintDocument и переопределите (см. переопределения для Visual Basic или переопределение для C#) событие PrintPage.

После добавления в форму компонент PrintDocument отображается на панели задач в нижней части конструктора Windows Forms в Visual Studio.

См. также