System.Drawing.Printing Пространство имен
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет службы, связанные с печатью, для приложений Windows Forms.
Классы
| Имя | Описание |
|---|---|
| InvalidPrinterException |
Представляет исключение, которое возникает при попытке доступа к принтеру с помощью параметров принтера, которые недопустимы. |
| Margins |
Задает размеры полей печатной страницы. |
| MarginsConverter |
MarginsConverter Предоставляет для Margins. |
| PageSettings |
Задает параметры, которые применяются к одной печатной странице. |
| PaperSize |
Задает размер листа бумаги. |
| PaperSource |
Указывает лоток бумаги, из которого принтер получает бумагу. |
| PreviewPageInfo |
Указывает сведения о предварительном просмотре печати для одной страницы. Этот класс не может быть унаследован. |
| PreviewPrintController |
Указывает контроллер печати, который отображает документ на экране в виде ряда изображений. |
| PrintController |
Управляет печатью документа при печати из приложения Windows Forms. |
| PrintDocument |
Определяет многократно используемый объект, который отправляет выходные данные на принтер при печати из приложения Windows Forms. |
| PrinterResolution |
Представляет разрешение, поддерживаемое принтером. |
| PrinterSettings |
Указывает сведения о том, как печатается документ, включая принтер, который печатает его при печати из приложения Windows Forms. |
| PrinterSettings.PaperSizeCollection |
Содержит коллекцию PaperSize объектов. |
| PrinterSettings.PaperSourceCollection |
Содержит коллекцию PaperSource объектов. |
| PrinterSettings.PrinterResolutionCollection |
Содержит коллекцию PrinterResolution объектов. |
| PrinterSettings.StringCollection |
Содержит коллекцию String объектов. |
| PrinterUnitConvert |
Задает ряд методов преобразования, которые полезны при взаимодействии с API печати Win32. Этот класс не может быть унаследован. |
| PrintEventArgs |
Предоставляет данные для событий BeginPrint и EndPrint. |
| PrintingPermission |
Управляет доступом к принтерам. Этот класс не может быть унаследован. |
| PrintingPermissionAttribute |
Разрешает декларативные проверки разрешений печати. |
| PrintPageEventArgs |
Предоставляет данные о событии PrintPage. |
| QueryPageSettingsEventArgs |
Предоставляет данные о событии QueryPageSettings. |
| StandardPrintController |
Указывает контроллер печати, который отправляет сведения на принтер. |
Перечисления
| Имя | Описание |
|---|---|
| Duplex |
Задает дуплексный параметр принтера. |
| PaperKind |
Указывает стандартные размеры бумаги. |
| PaperSourceKind |
Стандартные источники бумаги. |
| PrintAction |
Указывает тип операции печати. |
| PrinterResolutionKind |
Указывает разрешение принтера. |
| PrinterUnit |
Задает несколько единиц измерения, используемых для печати. |
| PrintingPermissionLevel |
Указывает тип печати, который разрешен для выполнения кода. |
| PrintRange |
Указывает часть документа для печати. |
Делегаты
| Имя | Описание |
|---|---|
| PrintEventHandler |
Представляет метод, который будет обрабатывать BeginPrint или EndPrint событие объекта PrintDocument. |
| PrintPageEventHandler |
Представляет метод, который будет обрабатывать PrintPage событие объекта PrintDocument. |
| QueryPageSettingsEventHandler |
Представляет метод, обрабатывающий QueryPageSettings событие объекта PrintDocument. |
Комментарии
Как правило, при печати из приложения Windows Forms создается новый экземпляр PrintDocument класса, задаются свойства, такие как DefaultPageSettings и PrinterSettings, которые описывают печать и вызов Print метода для фактической печати документа. PrintDocument.Print Вызов метода вызывает PrintDocument.PrintPage событие, которое должно обрабатываться для выполнения макета документа для печати.
Graphics Используйте свойство объекта, полученного PrintPageEventArgs из PrintDocument.PrintPage события, чтобы указать выходные данные для печати. Если вы печатаете текстовый файл, используйте StreamReader для чтения одной строки за раз из потока и вызова DrawString метода для рисования линии в графическом объекте. Дополнительные сведения об этом процессе см. в Graphics разделе и StreamReader классах. Пример печати текстового документа можно просмотреть в PrintDocument разделе обзора класса.
Замечание
DrawText Методы TextRenderer класса не поддерживаются для печати. Вместо этого используйте DrawString методы Graphics класса.
При реализации в производном классе PrintController элементы управления PrintDocument печатью. Метод PrintDocument.Print вызывает контроллер OnStartPrintпечати , OnEndPrintOnStartPageи OnEndPage методы, которые, в свою очередь, сообщают принтеру, как распечатать документ. Дополнительные сведения о печати диалоговых окон см. в разделе PrintDialog и PageSetupDialog.
В процессе предварительного просмотра печати используется специализированный контроллер печати, диалоговое окно и элемент управления. Пример такого контроллера печати и диалогового окна см. в разделе PreviewPrintController, PrintPreviewDialogа также PrintPreviewControl.
Предостережение
Классы в System.Drawing.Printing пространстве имен не поддерживаются для использования в службе Windows или ASP.NET приложения или службы. При попытке использовать эти классы из одного из этих типов приложений могут возникнуть непредвиденные проблемы, такие как снижение производительности службы и исключения во время выполнения.
Если вы хотите распечатать из приложения Windows Presentation Foundation (WPF), просмотрите System.Printing пространство имен.
